@atlaspack/packager-css 2.14.5-canary.31 → 2.14.5-canary.311

package/CHANGELOG.md

@@ -1,5 +1,295 @@
 # @atlaspack/packager-css
 
+## 2.15.1
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atlaspack/source-map@3.1.1
+  - @atlaspack/utils@3.2.1
+  - @atlaspack/types-internal@2.21.1
+  - @atlaspack/plugin@2.14.40
+
+## 2.15.0
+
+### Minor Changes
+
+- [#789](https://github.com/atlassian-labs/atlaspack/pull/789) [`73168c2`](https://github.com/atlassian-labs/atlaspack/commit/73168c275a5d9abff9907bcf536b340bca1ed5f0) Thanks [@marcins](https://github.com/marcins)! - Use an in-sourced version of @parcel/source-map, as @atlaspack/source-map
+
+### Patch Changes
+
+- Updated dependencies [[`8eb84ee`](https://github.com/atlassian-labs/atlaspack/commit/8eb84ee61a42bfe87c58079b610802b07a6a13e4), [`73168c2`](https://github.com/atlassian-labs/atlaspack/commit/73168c275a5d9abff9907bcf536b340bca1ed5f0), [`617a318`](https://github.com/atlassian-labs/atlaspack/commit/617a318ddc9419b38360257353fec50b9051ee13)]:
+  - @atlaspack/types-internal@2.21.0
+  - @atlaspack/source-map@3.1.0
+  - @atlaspack/utils@3.2.0
+  - @atlaspack/plugin@2.14.39
+
+## 2.14.38
+
+### Patch Changes
+
+- Updated dependencies [[`7d7a55d`](https://github.com/atlassian-labs/atlaspack/commit/7d7a55dd6395ec391a2e4c33b3dec0d1ea477d4c)]:
+  - @atlaspack/utils@3.1.2
+  - @atlaspack/types-internal@2.20.8
+  - @atlaspack/plugin@2.14.38
+
+## 2.14.37
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atlaspack/utils@3.1.1
+  - @atlaspack/types-internal@2.20.7
+  - @atlaspack/plugin@2.14.37
+
+## 2.14.36
+
+### Patch Changes
+
+- Updated dependencies [[`5776be2`](https://github.com/atlassian-labs/atlaspack/commit/5776be21f70a3f2b9471ba33da3ba1a883f21f1a)]:
+  - @atlaspack/utils@3.1.0
+  - @atlaspack/types-internal@2.20.6
+  - @atlaspack/plugin@2.14.36
+
+## 2.14.35
+
+### Patch Changes
+
+- Updated dependencies [[`c372f3f`](https://github.com/atlassian-labs/atlaspack/commit/c372f3fd6fce8200d5cf47f41bc7895c6cbb5558), [`17dfea9`](https://github.com/atlassian-labs/atlaspack/commit/17dfea9e9f3169807808520df9c09ebf70dc8b10)]:
+  - @atlaspack/types-internal@2.20.5
+  - @atlaspack/utils@3.0.3
+  - @atlaspack/plugin@2.14.35
+
+## 2.14.34
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atlaspack/types-internal@2.20.4
+  - @atlaspack/utils@3.0.2
+  - @atlaspack/plugin@2.14.34
+
+## 2.14.33
+
+### Patch Changes
+
+- Updated dependencies [[`236e546`](https://github.com/atlassian-labs/atlaspack/commit/236e5465863dca6044a7191e05260a5b924c342e)]:
+  - @atlaspack/utils@3.0.1
+  - @atlaspack/types-internal@2.20.3
+  - @atlaspack/plugin@2.14.33
+
+## 2.14.32
+
+### Patch Changes
+
+- Updated dependencies [[`1180103`](https://github.com/atlassian-labs/atlaspack/commit/118010351ed444f8178988afb3f77807154dd933)]:
+  - @atlaspack/utils@3.0.0
+  - @atlaspack/types-internal@2.20.2
+  - @atlaspack/plugin@2.14.32
+
+## 2.14.31
+
+### Patch Changes
+
+- [#785](https://github.com/atlassian-labs/atlaspack/pull/785) [`0e7dd5e`](https://github.com/atlassian-labs/atlaspack/commit/0e7dd5ec6fbe05aa9e0bb5775a9d0975f206a922) Thanks [@matt-koko](https://github.com/matt-koko)! - We need to re-publish every package in Atlaspack with the corrected types field.
+
+- Updated dependencies [[`0e7dd5e`](https://github.com/atlassian-labs/atlaspack/commit/0e7dd5ec6fbe05aa9e0bb5775a9d0975f206a922)]:
+  - @atlaspack/diagnostic@2.14.4
+  - @atlaspack/plugin@2.14.31
+  - @atlaspack/types-internal@2.20.1
+  - @atlaspack/utils@2.19.3
+
+## 2.14.30
+
+### Patch Changes
+
+- Updated dependencies [[`eedcbc4`](https://github.com/atlassian-labs/atlaspack/commit/eedcbc408fc1e86a2a8e25f1a41c57146d8529e1), [`f6532d7`](https://github.com/atlassian-labs/atlaspack/commit/f6532d7a4f7f007bd4e5e36af04dd466f0b9f572)]:
+  - @atlaspack/types-internal@2.20.0
+  - @atlaspack/utils@2.19.2
+  - @atlaspack/plugin@2.14.30
+
+## 2.14.29
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atlaspack/types-internal@2.19.5
+  - @atlaspack/utils@2.19.1
+  - @atlaspack/plugin@2.14.29
+
+## 2.14.28
+
+### Patch Changes
+
+- Updated dependencies [[`f0349a6`](https://github.com/atlassian-labs/atlaspack/commit/f0349a6b9b04755088f121095ca6301a2ada3767)]:
+  - @atlaspack/utils@2.19.0
+  - @atlaspack/types-internal@2.19.4
+  - @atlaspack/plugin@2.14.28
+
+## 2.14.27
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atlaspack/types-internal@2.19.3
+  - @atlaspack/utils@2.18.4
+  - @atlaspack/plugin@2.14.27
+
+## 2.14.26
+
+### Patch Changes
+
+- [#742](https://github.com/atlassian-labs/atlaspack/pull/742) [`ee040bb`](https://github.com/atlassian-labs/atlaspack/commit/ee040bb6428f29b57d892ddd8107e29077d08ffd) Thanks [@yamadapc](https://github.com/yamadapc)! - Internal changes and bug fixes to environmentDeduplication flag
+
+- Updated dependencies [[`ee040bb`](https://github.com/atlassian-labs/atlaspack/commit/ee040bb6428f29b57d892ddd8107e29077d08ffd), [`889c65c`](https://github.com/atlassian-labs/atlaspack/commit/889c65cd25b811045e26a117e7404f694dde77a2)]:
+  - @atlaspack/types-internal@2.19.2
+  - @atlaspack/diagnostic@2.14.3
+  - @atlaspack/plugin@2.14.26
+  - @atlaspack/utils@2.18.3
+
+## 2.14.25
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atlaspack/types-internal@2.19.1
+  - @atlaspack/utils@2.18.2
+  - @atlaspack/plugin@2.14.25
+
+## 2.14.24
+
+### Patch Changes
+
+- Updated dependencies [[`7f5841c`](https://github.com/atlassian-labs/atlaspack/commit/7f5841c39df049f9546cccbeea2a7337e0337b45)]:
+  - @atlaspack/types-internal@2.19.0
+  - @atlaspack/utils@2.18.1
+  - @atlaspack/plugin@2.14.24
+
+## 2.14.23
+
+### Patch Changes
+
+- Updated dependencies [[`23d561e`](https://github.com/atlassian-labs/atlaspack/commit/23d561e51e68b0c38fd1ff4e4fb173e5e7b01cf2)]:
+  - @atlaspack/utils@2.18.0
+  - @atlaspack/plugin@2.14.23
+
+## 2.14.22
+
+### Patch Changes
+
+- [#720](https://github.com/atlassian-labs/atlaspack/pull/720) [`d2fd849`](https://github.com/atlassian-labs/atlaspack/commit/d2fd849770fe6305e9c694bd97b1bd905abd9d94) Thanks [@alshdavid](https://github.com/alshdavid)! - Migrate to TypeScript
+
+- Updated dependencies [[`d2fd849`](https://github.com/atlassian-labs/atlaspack/commit/d2fd849770fe6305e9c694bd97b1bd905abd9d94)]:
+  - @atlaspack/diagnostic@2.14.2
+  - @atlaspack/plugin@2.14.22
+  - @atlaspack/utils@2.17.4
+
+## 2.14.21
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atlaspack/utils@2.17.3
+  - @atlaspack/plugin@2.14.21
+
+## 2.14.20
+
+### Patch Changes
+
+- [#702](https://github.com/atlassian-labs/atlaspack/pull/702) [`daaa768`](https://github.com/atlassian-labs/atlaspack/commit/daaa7688786772d7e3713b71c5bba6b89ec704aa) Thanks [@alshdavid](https://github.com/alshdavid)! - Fixes to Flow types
+
+- Updated dependencies [[`daaa768`](https://github.com/atlassian-labs/atlaspack/commit/daaa7688786772d7e3713b71c5bba6b89ec704aa)]:
+  - @atlaspack/plugin@2.14.20
+  - @atlaspack/utils@2.17.2
+
+## 2.14.19
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atlaspack/utils@2.17.1
+  - @atlaspack/plugin@2.14.19
+
+## 2.14.18
+
+### Patch Changes
+
+- Updated dependencies [[`dbb4072`](https://github.com/atlassian-labs/atlaspack/commit/dbb40721ebeb45990a14ba04e6b44e7f836fb32d), [`de23e0c`](https://github.com/atlassian-labs/atlaspack/commit/de23e0ce49d5504fe3947ac26640a3d951087da3), [`18a57cf`](https://github.com/atlassian-labs/atlaspack/commit/18a57cf8a4789b2de5ad8e2676f317a26cc91417), [`a5ed1b4`](https://github.com/atlassian-labs/atlaspack/commit/a5ed1b414498560f393ff491af4da25b6e8dde56)]:
+  - @atlaspack/utils@2.17.0
+  - @atlaspack/plugin@2.14.18
+
+## 2.14.17
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atlaspack/utils@2.16.1
+  - @atlaspack/plugin@2.14.17
+
+## 2.14.16
+
+### Patch Changes
+
+- Updated dependencies [[`30ee2cf`](https://github.com/atlassian-labs/atlaspack/commit/30ee2cfcd34cf2646ded0eda13fdb80a2a5de529)]:
+  - @atlaspack/utils@2.16.0
+  - @atlaspack/plugin@2.14.16
+
+## 2.14.15
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atlaspack/utils@2.15.3
+  - @atlaspack/plugin@2.14.15
+
+## 2.14.14
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atlaspack/utils@2.15.2
+  - @atlaspack/plugin@2.14.14
+
+## 2.14.13
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atlaspack/utils@2.15.1
+  - @atlaspack/plugin@2.14.13
+
+## 2.14.12
+
+### Patch Changes
+
+- Updated dependencies [[`e39c6cf`](https://github.com/atlassian-labs/atlaspack/commit/e39c6cf05f7e95ce5420dbcea66f401b1cbd397c)]:
+  - @atlaspack/utils@2.15.0
+  - @atlaspack/plugin@2.14.12
+
+## 2.14.11
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atlaspack/utils@2.14.11
+  - @atlaspack/plugin@2.14.11
+
+## 2.14.10
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atlaspack/plugin@2.14.10
+  - @atlaspack/utils@2.14.10
+
+## 2.14.9
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @atlaspack/utils@2.14.9
+  - @atlaspack/plugin@2.14.9
+
 ## 2.14.8
 
 ### Patch Changes

package/dist/CSSPackager.js

@@ -0,0 +1,330 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSpecifier = getSpecifier;
+const lightningcss_1 = __importStar(require("lightningcss"));
+const assert_1 = __importDefault(require("assert"));
+const nullthrows_1 = __importDefault(require("nullthrows"));
+const source_map_1 = __importDefault(require("@atlaspack/source-map"));
+const plugin_1 = require("@atlaspack/plugin");
+const diagnostic_1 = require("@atlaspack/diagnostic");
+const utils_1 = require("@atlaspack/utils");
+exports.default = new plugin_1.Packager({
+    async package({ bundle, bundleGraph, getInlineBundleContents, getSourceMapReference, logger, options, }) {
+        // Inline style attributes are parsed differently from full CSS files.
+        if (bundle.bundleBehavior === 'inline') {
+            let entry = bundle.getMainEntry();
+            if (entry?.meta.type === 'attr') {
+                return replaceReferences(bundle, bundleGraph, await entry.getCode(), await entry.getMap(), getInlineBundleContents);
+            }
+        }
+        let queue = new utils_1.PromiseQueue({
+            maxConcurrent: 32,
+        });
+        // @ts-expect-error TS2304
+        let hoistedImports = [];
+        let assetsByPlaceholder = new Map();
+        // @ts-expect-error TS7034
+        let entry = null;
+        let entryContents = '';
+        bundle.traverse({
+            enter: (node, context) => {
+                if (node.type === 'asset' && !context) {
+                    // If there is only one entry, we'll use it directly.
+                    // Otherwise, we'll create a fake bundle entry with @import rules for each root asset.
+                    // @ts-expect-error TS7005
+                    if (entry == null) {
+                        entry = node.value.id;
+                    }
+                    else {
+                        entry = bundle.id;
+                    }
+                    assetsByPlaceholder.set(node.value.id, node.value);
+                    entryContents += `@import "${node.value.id}";\n`;
+                }
+                return true;
+            },
+            exit: (node) => {
+                if (node.type === 'dependency') {
+                    let resolved = bundleGraph.getResolvedAsset(node.value, bundle);
+                    // Hoist unresolved external dependencies (i.e. http: imports)
+                    if (node.value.priority === 'sync' &&
+                        !bundleGraph.isDependencySkipped(node.value) &&
+                        !resolved) {
+                        hoistedImports.push(node.value.specifier);
+                    }
+                    if (resolved && bundle.hasAsset(resolved)) {
+                        assetsByPlaceholder.set(node.value.meta.placeholder ?? node.value.specifier, resolved);
+                    }
+                    return;
+                }
+                let asset = node.value;
+                queue.add(() => {
+                    if (!asset.symbols.isCleared &&
+                        options.mode === 'production' &&
+                        asset.astGenerator?.type === 'postcss') {
+                        // a CSS Modules asset
+                        return processCSSModule(options, logger, bundleGraph, bundle, asset);
+                    }
+                    else {
+                        return Promise.all([
+                            asset,
+                            asset.getCode().then((css) => {
+                                // Replace CSS variable references with resolved symbols.
+                                if (asset.meta.hasReferences) {
+                                    let replacements = new Map();
+                                    for (let dep of asset.getDependencies()) {
+                                        for (let [exported, { local }] of dep.symbols) {
+                                            let resolved = bundleGraph.getResolvedAsset(dep, bundle);
+                                            if (resolved) {
+                                                let resolution = bundleGraph.getSymbolResolution(resolved, exported, bundle);
+                                                if (resolution.symbol) {
+                                                    replacements.set(local, resolution.symbol);
+                                                }
+                                            }
+                                        }
+                                    }
+                                    if (replacements.size > 0) {
+                                        let regex = new RegExp([...replacements.keys()].join('|'), 'g');
+                                        css = css.replace(regex, (m) => escapeDashedIdent(replacements.get(m) || m));
+                                    }
+                                }
+                                return css;
+                            }),
+                            bundle.env.sourceMap ? asset.getMap() : null,
+                        ]);
+                    }
+                });
+            },
+        });
+        let outputs = new Map(
+        // @ts-expect-error TS2345
+        (await queue.run()).map(([asset, code, map]) => [
+            asset,
+            [code, map],
+        ]));
+        let map = new source_map_1.default(options.projectRoot);
+        // @ts-expect-error TS2339
+        if (process.browser) {
+            // @ts-expect-error TS2349
+            await (0, lightningcss_1.default)();
+        }
+        let res = await (0, lightningcss_1.bundleAsync)({
+            // @ts-expect-error TS2322
+            filename: (0, nullthrows_1.default)(entry),
+            sourceMap: !!bundle.env.sourceMap,
+            resolver: {
+                resolve(specifier) {
+                    return specifier;
+                },
+                async read(file) {
+                    if (file === bundle.id) {
+                        return entryContents;
+                    }
+                    let asset = assetsByPlaceholder.get(file);
+                    if (!asset) {
+                        return '';
+                    }
+                    let [code, map] = (0, nullthrows_1.default)(outputs.get(asset));
+                    if (map) {
+                        let sm = await map.stringify({ format: 'inline' });
+                        (0, assert_1.default)(typeof sm === 'string');
+                        code += `\n/*# sourceMappingURL=${sm} */`;
+                    }
+                    return code;
+                },
+            },
+        });
+        let contents = res.code.toString();
+        if (res.map) {
+            let vlqMap = JSON.parse(res.map.toString());
+            map.addVLQMap(vlqMap);
+            let reference = await getSourceMapReference(map);
+            if (reference != null) {
+                contents += '/*# sourceMappingURL=' + reference + ' */\n';
+            }
+        }
+        // Prepend hoisted external imports.
+        if (hoistedImports.length > 0) {
+            let lineOffset = 0;
+            let hoistedCode = '';
+            for (let url of hoistedImports) {
+                hoistedCode += `@import "${url}";\n`;
+                lineOffset++;
+            }
+            if (bundle.env.sourceMap) {
+                map.offsetLines(1, lineOffset);
+            }
+            contents = hoistedCode + contents;
+        }
+        return replaceReferences(bundle, bundleGraph, contents, map, getInlineBundleContents);
+    },
+});
+function replaceReferences(
+// @ts-expect-error TS2304
+bundle, 
+// @ts-expect-error TS2304
+bundleGraph, contents, 
+// @ts-expect-error TS2552
+map, getInlineBundleContents) {
+    ({ contents, map } = (0, utils_1.replaceURLReferences)({
+        bundle,
+        bundleGraph,
+        contents,
+        map,
+        getReplacement: escapeString,
+    }));
+    return (0, utils_1.replaceInlineReferences)({
+        bundle,
+        bundleGraph,
+        contents,
+        getInlineBundleContents,
+        getInlineReplacement: (dep, inlineType, contents) => ({
+            from: getSpecifier(dep),
+            to: escapeString(contents),
+        }),
+        map,
+    });
+}
+function getSpecifier(dep) {
+    if (typeof dep.meta.placeholder === 'string') {
+        return dep.meta.placeholder;
+    }
+    return dep.id;
+}
+function escapeString(contents) {
+    return contents.replace(/(["\\])/g, '\\$1');
+}
+async function processCSSModule(
+// @ts-expect-error TS2552
+options, 
+// @ts-expect-error TS2304
+logger, 
+// @ts-expect-error TS2304
+bundleGraph, 
+// @ts-expect-error TS2304
+bundle, asset) {
+    // @ts-expect-error TS2709
+    let postcss = await options.packageManager.require('postcss', options.projectRoot + '/index', {
+        range: '^8.4.5',
+        saveDev: true,
+        shouldAutoInstall: options.shouldAutoInstall,
+    });
+    let ast = postcss.fromJSON((0, nullthrows_1.default)((await asset.getAST())?.program));
+    let usedSymbols = bundleGraph.getUsedSymbols(asset);
+    if (usedSymbols != null) {
+        let localSymbols = new Set([...asset.symbols].map(([, { local }]) => `.${local}`));
+        let defaultImport = null;
+        if (usedSymbols.has('default')) {
+            let incoming = bundleGraph.getIncomingDependencies(asset);
+            // @ts-expect-error TS7006
+            defaultImport = incoming.find((d) => d.symbols.hasExportSymbol('default'));
+            if (defaultImport) {
+                let loc = defaultImport.symbols.get('default')?.loc;
+                logger.warn({
+                    message: 'CSS modules cannot be tree shaken when imported with a default specifier',
+                    ...(loc && {
+                        codeFrames: [
+                            {
+                                filePath: (0, nullthrows_1.default)(loc?.filePath ?? defaultImport.sourcePath),
+                                codeHighlights: [(0, diagnostic_1.convertSourceLocationToHighlight)(loc)],
+                            },
+                        ],
+                    }),
+                    hints: [
+                        `Instead do: import * as style from "${defaultImport.specifier}";`,
+                    ],
+                    documentationURL: 'https://parceljs.org/languages/css/#tree-shaking',
+                });
+            }
+        }
+        if (!defaultImport && !usedSymbols.has('*')) {
+            let usedLocalSymbols = new Set([...usedSymbols].map((exportSymbol) => `.${(0, nullthrows_1.default)(asset.symbols.get(exportSymbol)).local}`));
+            ast.walkRules((rule) => {
+                if (localSymbols.has(rule.selector) &&
+                    !usedLocalSymbols.has(rule.selector)) {
+                    rule.remove();
+                }
+            });
+        }
+    }
+    let { content, map } = await postcss().process(ast, {
+        from: undefined,
+        to: options.projectRoot + '/index',
+        map: {
+            annotation: false,
+            inline: false,
+        },
+        // Pass postcss's own stringifier to it to silence its warning
+        // as we don't want to perform any transformations -- only generate
+        stringifier: postcss.stringify,
+    });
+    let sourceMap;
+    if (bundle.env.sourceMap && map != null) {
+        sourceMap = new source_map_1.default(options.projectRoot);
+        sourceMap.addVLQMap(map.toJSON());
+    }
+    return [asset, content, sourceMap];
+}
+function escapeDashedIdent(name) {
+    // https://drafts.csswg.org/cssom/#serialize-an-identifier
+    let res = '';
+    // @ts-expect-error TS2488
+    for (let c of name) {
+        let code = c.codePointAt(0);
+        if (code === 0) {
+            res += '\ufffd';
+        }
+        else if ((code >= 0x1 && code <= 0x1f) || code === 0x7f) {
+            res += '\\' + code.toString(16) + ' ';
+        }
+        else if ((code >= 48 /* '0' */ && code <= 57) /* '9' */ ||
+            (code >= 65 /* 'A' */ && code <= 90) /* 'Z' */ ||
+            (code >= 97 /* 'a' */ && code <= 122) /* 'z' */ ||
+            code === 95 /* '_' */ ||
+            code === 45 /* '-' */ ||
+            code & 128 // non-ascii
+        ) {
+            res += c;
+        }
+        else {
+            res += '\\' + c;
+        }
+    }
+    return res;
+}