@terrazzo/parser 0.1.3 → 0.2.1

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @terrazzo/parser@0.2.1 build /home/runner/work/terrazzo/terrazzo/packages/parser
+> tsc -p tsconfig.build.json
+

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @terrazzo/parser
 
+## 0.2.1
+
+### Patch Changes
+
+- [#358](https://github.com/terrazzoapp/terrazzo/pull/358) [`6b3c543`](https://github.com/terrazzoapp/terrazzo/commit/6b3c543a3356c582522f6e2d9b2948a0634a66df) Thanks [@christoph-fricke](https://github.com/christoph-fricke)! - Fix npm error when invoking the Terrazzo CLI through npm
+
+## 0.2.0
+
+### Minor Changes
+
+- [#353](https://github.com/terrazzoapp/terrazzo/pull/353) [`80e04c3`](https://github.com/terrazzoapp/terrazzo/commit/80e04c36a354234e04153a8332ebddd5360247aa) Thanks [@drwpow](https://github.com/drwpow)! - Add lint API
+
+### Patch Changes
+
+- [#353](https://github.com/terrazzoapp/terrazzo/pull/353) [`80e04c3`](https://github.com/terrazzoapp/terrazzo/commit/80e04c36a354234e04153a8332ebddd5360247aa) Thanks [@drwpow](https://github.com/drwpow)! - Add support for $deprecated tokens
+
+- [#353](https://github.com/terrazzoapp/terrazzo/pull/353) [`80e04c3`](https://github.com/terrazzoapp/terrazzo/commit/80e04c36a354234e04153a8332ebddd5360247aa) Thanks [@drwpow](https://github.com/drwpow)! - Fix bug in alias resolution
+
+- [#353](https://github.com/terrazzoapp/terrazzo/pull/353) [`80e04c3`](https://github.com/terrazzoapp/terrazzo/commit/80e04c36a354234e04153a8332ebddd5360247aa) Thanks [@drwpow](https://github.com/drwpow)! - Fix type error with parser output
+
+- Updated dependencies [[`80e04c3`](https://github.com/terrazzoapp/terrazzo/commit/80e04c36a354234e04153a8332ebddd5360247aa), [`80e04c3`](https://github.com/terrazzoapp/terrazzo/commit/80e04c36a354234e04153a8332ebddd5360247aa), [`80e04c3`](https://github.com/terrazzoapp/terrazzo/commit/80e04c36a354234e04153a8332ebddd5360247aa)]:
+  - @terrazzo/token-tools@0.2.0
+
 ## 0.1.3
 
 ### Patch Changes

package/CONTRIBUTING.md

@@ -11,15 +11,3 @@ This document contains developer notes and context for @terrazzo/parser. For gen
 ## What this package DOES NOT do
 
 - Write files to disk (that’s a job for Node.js; this can be run in a browser)
-
-## Manual JS and DTS
-
-This package is unique in its manual handling of `.js` and `.d.ts` files (TypeScript definitions). The expected norm is to write `.ts`, and have `.js` and `.d.ts` be generated automatically from source. But in this project, we write `.js` by hand because this specific module has several unique concerns:
-
-1. **It’s dealing with external (possibly invalid) code.** Now, you’d think that `.ts` would be better at handling this, but the reality when dealing with user-submitted code is if you type it too strongly, TS lulls you into a false sense of security and misses necessary assertions. If you type it weakly, then TS requires _too many_ assertions and you end up with boilerplate and noise. Or if you don’t type it at all, then TS doesn’t really provide any value in the first place, and you might as well skip it.
-
-2. **It’s dealing with ASTs.** We’re parsing JSON ASTs using Momoa, and building ad hoc structures on-the-fly. ASTs usually trip TS up because the discrimination isn’t clear (e.g. if `.type == 'foo'`, then `[property]` exists). Most ASTs don’t have perfect types out-of-the-box, and attempting to re-type an AST yourself is overkill. Further, to the previous point, we may be dealing with invalid code, and the AST may not always be in predictable shapes! When faced with these problems, TS at best requires extra boilerplate; at worst guides you into incorrect decisions.
-
-Given both of these, you usually end up with so many `// @ts-ignore`s or `as any`s that TS doesn’t provide benefit.
-
-But this package is unique! Look in any other package in this monorepo, and you’ll see it’s fully written in `.ts` source files. Different concerns require different approaches.

package/dist/build/index.d.ts

@@ -0,0 +1,19 @@
+import type { DocumentNode } from '@humanwhocodes/momoa';
+import { type TokenNormalized } from '@terrazzo/token-tools';
+import Logger from '../logger.js';
+import type { BuildRunnerResult, ConfigInit } from '../types.js';
+export interface BuildRunnerOptions {
+    sources: {
+        filename?: URL;
+        src: string;
+        document: DocumentNode;
+    }[];
+    config: ConfigInit;
+    logger?: Logger;
+}
+export declare const SINGLE_VALUE = "SINGLE_VALUE";
+export declare const MULTI_VALUE = "MULTI_VALUE";
+/**
+ * Run build stage
+ */
+export default function build(tokens: Record<string, TokenNormalized>, { sources, logger, config }: BuildRunnerOptions): Promise<BuildRunnerResult>;

package/dist/build/index.js

@@ -0,0 +1,165 @@
+import { isTokenMatch } from '@terrazzo/token-tools';
+import wcmatch from 'wildcard-match';
+import Logger from '../logger.js';
+export const SINGLE_VALUE = 'SINGLE_VALUE';
+export const MULTI_VALUE = 'MULTI_VALUE';
+/** Validate plugin setTransform() calls for immediate feedback */
+function validateTransformParams({ params, logger, pluginName, }) {
+    const baseEntry = { group: 'plugin', label: pluginName, message: '' };
+    // validate value is valid for SINGLE_VALUE or MULTI_VALUE
+    if (!params.value ||
+        (typeof params.value !== 'string' && typeof params.value !== 'object') ||
+        Array.isArray(params.value)) {
+        logger.error({
+            ...baseEntry,
+            message: `setTransform() value expected string or object of strings, received ${Array.isArray(params.value) ? 'Array' : typeof params.value}`,
+        });
+    }
+    if (typeof params.value === 'object' && Object.values(params.value).some((v) => typeof v !== 'string')) {
+        logger.error({
+            ...baseEntry,
+            message: 'setTransform() value expected object of strings, received some non-string values',
+        });
+    }
+}
+/**
+ * Run build stage
+ */
+export default async function build(tokens, { sources, logger = new Logger(), config }) {
+    const formats = {};
+    const result = { outputFiles: [] };
+    function getTransforms(params) {
+        return (formats[params.format] ?? []).filter((token) => {
+            if (params.$type) {
+                if (typeof params.$type === 'string' && token.token.$type !== params.$type) {
+                    return false;
+                }
+                else if (Array.isArray(params.$type) && !params.$type.some(($type) => token.token.$type === $type)) {
+                    return false;
+                }
+            }
+            if (params.id &&
+                params.id !== '*' &&
+                !isTokenMatch(token.token.id, Array.isArray(params.id) ? params.id : [params.id])) {
+                return false;
+            }
+            if (params.mode && !wcmatch(params.mode)(token.mode)) {
+                return false;
+            }
+            return true;
+        });
+    }
+    // transform()
+    let transformsLocked = false; // prevent plugins from transforming after stage has ended
+    const startTransform = performance.now();
+    logger.debug({ group: 'parser', label: 'transform', message: 'Start transform' });
+    for (const plugin of config.plugins) {
+        if (typeof plugin.transform === 'function') {
+            await plugin.transform({
+                tokens,
+                sources,
+                getTransforms,
+                setTransform(id, params) {
+                    if (transformsLocked) {
+                        logger.warn({
+                            message: 'Attempted to call setTransform() after transform step has completed.',
+                            group: 'plugin',
+                            label: plugin.name,
+                        });
+                        return;
+                    }
+                    const token = tokens[id];
+                    // allow `undefined` values, but remove them here
+                    const cleanValue = typeof params.value === 'string' ? params.value : { ...params.value };
+                    if (typeof cleanValue === 'object') {
+                        for (const k of Object.keys(cleanValue)) {
+                            if (Object.hasOwn(cleanValue, k)) {
+                                if (cleanValue[k] === undefined) {
+                                    delete cleanValue[k];
+                                }
+                            }
+                        }
+                    }
+                    validateTransformParams({
+                        logger,
+                        params: { ...params, value: cleanValue },
+                        pluginName: plugin.name,
+                    });
+                    // upsert
+                    if (!formats[params.format]) {
+                        formats[params.format] = [];
+                    }
+                    const foundTokenI = formats[params.format].findIndex((t) => id === t.id && params.localID === t.localID && (!params.mode || params.mode === t.mode));
+                    if (foundTokenI === -1) {
+                        formats[params.format].push({
+                            ...params,
+                            id,
+                            value: cleanValue,
+                            type: typeof cleanValue === 'string' ? SINGLE_VALUE : MULTI_VALUE,
+                            mode: params.mode || '.',
+                            token: structuredClone(token),
+                        });
+                    }
+                    else {
+                        formats[params.format][foundTokenI].value = cleanValue;
+                        formats[params.format][foundTokenI].type = typeof cleanValue === 'string' ? SINGLE_VALUE : MULTI_VALUE;
+                    }
+                },
+            });
+        }
+    }
+    transformsLocked = true;
+    logger.debug({
+        group: 'parser',
+        label: 'transform',
+        message: 'Finish transform',
+        timing: performance.now() - startTransform,
+    });
+    // build()
+    const startBuild = performance.now();
+    logger.debug({ group: 'parser', label: 'build', message: 'Start build' });
+    for (const plugin of config.plugins) {
+        if (typeof plugin.build === 'function') {
+            const pluginBuildStart = performance.now();
+            await plugin.build({
+                tokens,
+                sources,
+                getTransforms,
+                outputFile(filename, contents) {
+                    const resolved = new URL(filename, config.outDir);
+                    if (result.outputFiles.some((f) => new URL(f.filename, config.outDir).href === resolved.href)) {
+                        logger.error({ message: `Can’t overwrite file "${filename}"`, label: plugin.name });
+                    }
+                    result.outputFiles.push({
+                        filename,
+                        contents,
+                        plugin: plugin.name,
+                        time: performance.now() - pluginBuildStart,
+                    });
+                },
+            });
+        }
+    }
+    logger.debug({
+        group: 'parser',
+        label: 'build',
+        message: 'Finish build',
+        timing: performance.now() - startBuild,
+    });
+    // buildEnd()
+    const startBuildEnd = performance.now();
+    logger.debug({ group: 'parser', label: 'build', message: 'Start buildEnd' });
+    for (const plugin of config.plugins) {
+        if (typeof plugin.buildEnd === 'function') {
+            await plugin.buildEnd({ outputFiles: structuredClone(result.outputFiles) });
+        }
+    }
+    logger.debug({
+        group: 'parser',
+        label: 'build',
+        message: 'Finish buildEnd',
+        timing: performance.now() - startBuildEnd,
+    });
+    return result;
+}
+//# sourceMappingURL=index.js.map

package/dist/build/index.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,7 @@
+import type { Config, ConfigInit, ConfigOptions } from './types.js';
+/**
+ * Validate and normalize a config
+ */
+export default function defineConfig(rawConfig: Config, { logger, cwd }?: ConfigOptions): ConfigInit;
+/** Merge configs */
+export declare function mergeConfigs(a: Config, b: Config): Config;

package/dist/config.js

@@ -0,0 +1,269 @@
+import { merge } from 'merge-anything';
+import coreLintPlugin from './lint/plugin-core/index.js';
+import Logger from './logger.js';
+const TRAILING_SLASH_RE = /\/*$/;
+/**
+ * Validate and normalize a config
+ */
+export default function defineConfig(rawConfig, { logger = new Logger(), cwd } = {}) {
+    const configStart = performance.now();
+    if (!cwd) {
+        logger.error({ label: 'core', message: 'defineConfig() missing `cwd` for JS API' });
+    }
+    logger.debug({ group: 'parser', label: 'config', message: 'Start config validation' });
+    const config = merge({}, rawConfig);
+    // 1. normalize and init
+    normalizeTokens({ rawConfig, config, logger, cwd });
+    normalizeOutDir({ config, cwd, logger });
+    normalizePlugins({ config, logger });
+    normalizeLint({ config, logger });
+    normalizeIgnore({ config, logger });
+    // 2. Start build by calling config()
+    for (const plugin of config.plugins) {
+        plugin.config?.({ ...config });
+    }
+    // 3. finish
+    logger.debug({
+        group: 'parser',
+        label: 'config',
+        message: 'Finish config validation',
+        timing: performance.now() - configStart,
+    });
+    return config;
+}
+/** Normalize config.tokens */
+function normalizeTokens({ rawConfig, config, logger, cwd, }) {
+    if (rawConfig.tokens === undefined) {
+        config.tokens = [
+            // @ts-ignore we’ll normalize in next step
+            './tokens.json',
+        ];
+    }
+    else if (typeof rawConfig.tokens === 'string') {
+        config.tokens = [
+            // @ts-ignore we’ll normalize in next step
+            rawConfig.tokens,
+        ];
+    }
+    else if (Array.isArray(rawConfig.tokens)) {
+        config.tokens = [];
+        for (const file of rawConfig.tokens) {
+            if (typeof file === 'string' || file instanceof URL) {
+                config.tokens.push(
+                // @ts-ignore we’ll normalize in next step
+                file);
+            }
+            else {
+                logger.error({
+                    label: '[config] tokens',
+                    message: `Expected array of strings, encountered ${JSON.stringify(file)}`,
+                });
+            }
+        }
+    }
+    else {
+        logger.error({
+            label: '[config] tokens',
+            message: `Expected string or array of strings, received ${typeof rawConfig.tokens}`,
+        });
+    }
+    for (let i = 0; i < config.tokens.length; i++) {
+        const filepath = config.tokens[i];
+        if (filepath instanceof URL) {
+            continue; // skip if already resolved
+        }
+        try {
+            config.tokens[i] = new URL(filepath, cwd);
+        }
+        catch (err) {
+            logger.error({ label: '[config] tokens', message: `Invalid URL ${filepath}` });
+        }
+    }
+}
+/** Normalize config.outDir */
+function normalizeOutDir({ config, cwd, logger }) {
+    if (config.outDir instanceof URL) {
+        // noop
+    }
+    else if (typeof config.outDir === 'undefined') {
+        config.outDir = new URL('./tokens/', cwd);
+    }
+    else if (typeof config.outDir !== 'string') {
+        logger.error({ label: '[config] outDir', message: `Expected string, received ${JSON.stringify(config.outDir)}` });
+    }
+    else {
+        config.outDir = new URL(config.outDir, cwd);
+        // always add trailing slash so URL treats it as a directory.
+        // do AFTER it has been normalized to POSIX paths with `href` (don’t use Node internals here! This may run in the browser)
+        config.outDir = new URL(config.outDir.href.replace(TRAILING_SLASH_RE, '/'));
+    }
+}
+/** Normalize config.plugins */
+function normalizePlugins({ config, logger }) {
+    if (typeof config.plugins === 'undefined') {
+        config.plugins = [];
+    }
+    if (!Array.isArray(config.plugins)) {
+        logger.error({
+            label: '[config] plugins',
+            message: `Expected array of plugins, received ${JSON.stringify(config.plugins)}`,
+        });
+    }
+    config.plugins.push(coreLintPlugin());
+    for (let n = 0; n < config.plugins.length; n++) {
+        const plugin = config.plugins[n];
+        if (typeof plugin !== 'object') {
+            logger.error({ label: `plugin[${n}]`, message: `Expected output plugin, received ${JSON.stringify(plugin)}` });
+        }
+        else if (!plugin.name) {
+            logger.error({ label: `plugin[${n}]`, message: `Missing "name"` });
+        }
+    }
+    // order plugins with "enforce"
+    config.plugins.sort((a, b) => {
+        if (a.enforce === 'pre' && b.enforce !== 'pre') {
+            return -1;
+        }
+        else if (a.enforce === 'post' && b.enforce !== 'post') {
+            return 1;
+        }
+        return 0;
+    });
+}
+function normalizeLint({ config, logger }) {
+    if (config.lint !== undefined) {
+        if (config.lint === null || typeof config.lint !== 'object' || Array.isArray(config.lint)) {
+            logger.error({ label: '[config] lint', message: 'Must be an object' });
+        }
+        if (!config.lint.build) {
+            config.lint.build = { enabled: true };
+        }
+        if (config.lint.build.enabled !== undefined) {
+            if (typeof config.lint.build.enabled !== 'boolean') {
+                logger.error({
+                    label: '[config] lint › build › enabled',
+                    message: `Expected boolean, received ${JSON.stringify(config.lint.build)}`,
+                });
+            }
+        }
+        else {
+            config.lint.build.enabled = true;
+        }
+        if (config.lint.rules === undefined) {
+            config.lint.rules = {};
+        }
+        else {
+            if (config.lint.rules === null || typeof config.lint.rules !== 'object' || Array.isArray(config.lint.rules)) {
+                logger.error({
+                    label: '[config] lint › rules',
+                    message: `Expected object, received ${JSON.stringify(config.lint.rules)}`,
+                });
+                return;
+            }
+            const allRules = new Map();
+            for (const plugin of config.plugins) {
+                if (typeof plugin.lint !== 'function') {
+                    continue;
+                }
+                const pluginRules = plugin.lint();
+                if (!pluginRules || Array.isArray(pluginRules) || typeof pluginRules !== 'object') {
+                    logger.error({
+                        label: `[config] plugin › ${plugin.name}`,
+                        message: `Expected object for lint() received ${JSON.stringify(pluginRules)}`,
+                    });
+                    continue;
+                }
+                for (const rule of Object.keys(pluginRules)) {
+                    // Note: sometimes plugins will be loaded multiple times, in which case it’s expected
+                    // they’re register rules again for lint(). Only throw an error if plugin A and plugin B’s
+                    // rules conflict.
+                    if (allRules.get(rule) && allRules.get(rule) !== plugin.name) {
+                        logger.error({
+                            label: `[config] plugin › ${plugin.name}`,
+                            message: `Duplicate rule ${rule} already registered by plugin ${allRules.get(rule)}`,
+                        });
+                    }
+                    allRules.set(rule, plugin.name);
+                }
+            }
+            for (const id of Object.keys(config.lint.rules)) {
+                if (!allRules.has(id)) {
+                    logger.error({
+                        label: `[config] lint › rule › ${id}`,
+                        message: 'Unknown rule. Is the plugin installed?',
+                    });
+                }
+                const value = config.lint.rules[id];
+                let severity = 'off';
+                let options;
+                if (typeof value === 'number' || typeof value === 'string') {
+                    severity = value;
+                }
+                else if (Array.isArray(value)) {
+                    severity = value[0];
+                    options = value[1];
+                }
+                else if (value !== undefined) {
+                    logger.error({
+                        label: `[config] lint › rule › ${id}`,
+                        message: `Invalid eyntax. Expected \`string | number | Array\`, received ${JSON.stringify(value)}}`,
+                    });
+                }
+                config.lint.rules[id] = [severity, options];
+                if (typeof severity === 'number') {
+                    if (severity !== 0 && severity !== 1 && severity !== 2) {
+                        logger.error({
+                            label: `[config] lint › rule › ${id}`,
+                            message: `Invalid number ${severity}. Specify 0 (off), 1 (warn), or 2 (error).`,
+                        });
+                    }
+                    config.lint.rules[id][0] = ['off', 'warn', 'error'][severity];
+                }
+                else if (typeof severity === 'string') {
+                    if (severity !== 'off' && severity !== 'warn' && severity !== 'error') {
+                        logger.error({
+                            label: `[config] lint › rule › ${id}`,
+                            message: `Invalid string ${JSON.stringify(severity)}. Specify "off", "warn", or "error".`,
+                        });
+                    }
+                }
+                else if (value !== null) {
+                    logger.error({
+                        label: `[config] lint › rule › ${id}`,
+                        message: `Expected string or number, received ${JSON.stringify(value)}`,
+                    });
+                }
+            }
+        }
+    }
+    else {
+        config.lint = {
+            build: { enabled: true },
+            rules: {},
+        };
+    }
+}
+function normalizeIgnore({ config, logger }) {
+    if (!config.ignore) {
+        config.ignore = {};
+    }
+    config.ignore.tokens ??= [];
+    config.ignore.deprecated ??= false;
+    if (!Array.isArray(config.ignore.tokens) || config.ignore.tokens.some((x) => typeof x !== 'string')) {
+        logger.error({
+            label: '[config] ignore › tokens',
+            message: `Expected array of strings, received ${JSON.stringify(config.ignore.tokens)}`,
+        });
+    }
+    if (typeof config.ignore.deprecated !== 'boolean') {
+        logger.error({
+            label: '[config] ignore › deprecated',
+            message: `Expected boolean, received ${JSON.stringify(config.ignore.deprecated)}`,
+        });
+    }
+}
+/** Merge configs */
+export function mergeConfigs(a, b) {
+    return merge(a, b);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/{index.d.ts → dist/index.d.ts}

@@ -1,16 +1,12 @@
 export { default as build } from './build/index.js';
 export * from './build/index.js';
-
 export { default as defineConfig } from './config.js';
 export * from './config.js';
-
 export { default as lintRunner } from './lint/index.js';
 export * from './lint/index.js';
-
 export { default as Logger } from './logger.js';
 export * from './logger.js';
-
 export { default as parse } from './parse/index.js';
 export * from './parse/index.js';
-
+export * from './types.js';
 export * from '@terrazzo/token-tools/dist/types.js';

package/dist/index.js

@@ -0,0 +1,13 @@
+export { default as build } from './build/index.js';
+export * from './build/index.js';
+export { default as defineConfig } from './config.js';
+export * from './config.js';
+export { default as lintRunner } from './lint/index.js';
+export * from './lint/index.js';
+export { default as Logger } from './logger.js';
+export * from './logger.js';
+export { default as parse } from './parse/index.js';
+export * from './parse/index.js';
+export * from './types.js';
+export * from '@terrazzo/token-tools/dist/types.js';
+//# 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,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACpD,cAAc,kBAAkB,CAAC;AAEjC,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AACtD,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACxD,cAAc,iBAAiB,CAAC;AAEhC,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACpD,cAAc,kBAAkB,CAAC;AAEjC,cAAc,YAAY,CAAC;AAE3B,cAAc,qCAAqC,CAAC"}

package/dist/lib/code-frame.d.ts

@@ -0,0 +1,30 @@
+export interface Location {
+    line: number;
+    column: number;
+}
+export interface NodeLocation {
+    end?: Location;
+    start: Location;
+}
+export interface Options {
+    /** Syntax highlight the code as JavaScript for terminals. default: false */
+    highlightCode?: boolean;
+    /**  The number of lines to show above the error. default: 2 */
+    linesAbove?: number;
+    /**  The number of lines to show below the error. default: 3 */
+    linesBelow?: number;
+    /**
+     * Forcibly syntax highlight the code as JavaScript (for non-terminals);
+     * overrides highlightCode.
+     * default: false
+     */
+    forceColor?: boolean;
+    /**
+     * Pass in a string to be displayed inline (if possible) next to the
+     * highlighted location in the code. If it can't be positioned inline,
+     * it will be placed above the code frame.
+     * default: nothing
+     */
+    message?: string;
+}
+export declare function codeFrameColumns(rawLines: string, loc: NodeLocation, opts?: Options): string;