@checkdigit/typescript-config 3.3.0-PR.30-dfde → 3.3.0-PR.30-d5d5
Sign up to get free protection for your applications and to get access to all the features.
- package/README.md +37 -3
- package/bin/builder.mjs +16 -10
- package/package.json +1 -1
- package/src/builder/builder.mts +3 -3
- package/src/builder/index.mts +7 -1
package/README.md
CHANGED
|
@@ -6,7 +6,9 @@ Copyright (c) 2022-2023 [Check Digit, LLC](https://checkdigit.com)
|
|
|
6
6
|
|
|
7
7
|
### Introduction
|
|
8
8
|
|
|
9
|
-
This module contains the standard Check Digit Typescript configuration
|
|
9
|
+
This module contains the standard Check Digit Typescript configuration, along with our standard build tool `builder`.
|
|
10
|
+
|
|
11
|
+
### Typescript Configuration
|
|
10
12
|
|
|
11
13
|
- currently requires Node 16 or above.
|
|
12
14
|
- emits `esnext`, with the default libraries, to avoid down-leveling. It is intended that application spec tests pick
|
|
@@ -15,17 +17,49 @@ This module contains the standard Check Digit Typescript configuration.
|
|
|
15
17
|
- uses the `module` type of `commonjs`.
|
|
16
18
|
- all compiler options set for maximum strictness.
|
|
17
19
|
|
|
20
|
+
### Builder
|
|
21
|
+
|
|
22
|
+
`builder` is a command line tool that generates either commonjs or esm modules, from Typescript source. It is intended
|
|
23
|
+
to be used when publishing a package to NPM, or to bundle a package for deployment. It uses `tsc` for generating
|
|
24
|
+
types, and `esbuild` for generating code.
|
|
25
|
+
|
|
26
|
+
#### Options
|
|
27
|
+
|
|
28
|
+
- `--type` the type of module to generate. Defaults to `module` (ESM). Valid values are `commonjs` and `module`.
|
|
29
|
+
- `--entryPoint` the entry point for the bundle, relative to the inDir. if not provided, the files in the inDir will
|
|
30
|
+
be processed as individual unbundled files.
|
|
31
|
+
- `--inDir` the input source code directory.
|
|
32
|
+
- `--outDir` the output directory.
|
|
33
|
+
- `--outFile` the output file, relative to `--outDir`. This is provided for single-file bundles, along with `--entryPoint`.
|
|
34
|
+
- `--external` external modules to exclude from the bundle. Built-in `node` modules are automatically excluded.
|
|
35
|
+
A wildcard `*` can be used to exclude multiple external modules.
|
|
36
|
+
|
|
37
|
+
#### Examples
|
|
38
|
+
|
|
39
|
+
```
|
|
40
|
+
# build commonjs .cjs files from Typescript source
|
|
41
|
+
npx builder --type=commonjs --outDir=build-cjs
|
|
42
|
+
|
|
43
|
+
# build single-file commonjs .cjs bundle from Typescript source
|
|
44
|
+
npx builder --type=commonjs --entryPoint=index.ts --outDir=build-cjs-bundle --outFile=index.cjs
|
|
45
|
+
|
|
46
|
+
# build ESM .mjs files from Typescript source
|
|
47
|
+
npx builder --type=module --outDir=build-esm
|
|
48
|
+
|
|
49
|
+
# build single-file ESM .mjs bundle from Typescript source
|
|
50
|
+
npx builder --type=module --outDir=build-esm-bundle --entryPoint=index.ts --outFile=index.mjs
|
|
51
|
+
```
|
|
52
|
+
|
|
18
53
|
### Tests
|
|
19
54
|
|
|
20
55
|
This module includes a number of integration-style tests, to ensure that a specific version of Typescript will interoperate
|
|
21
|
-
with
|
|
56
|
+
with `builder`, in addition to libraries and frameworks used by Check Digit:
|
|
22
57
|
|
|
23
58
|
- Jest and `ts-jest`
|
|
24
59
|
- ESLint and `@typescript-eslint/eslint-plugin`
|
|
25
60
|
- Built-in `node:test` runner
|
|
26
61
|
- prettier
|
|
27
62
|
- tsc
|
|
28
|
-
- swc
|
|
29
63
|
- esbuild
|
|
30
64
|
|
|
31
65
|
We do this to ensure that Typescript upgrades do not break these dependencies. New major versions of Typescript are not immediately
|
package/bin/builder.mjs
CHANGED
|
@@ -41,19 +41,19 @@ function setup(type2) {
|
|
|
41
41
|
}
|
|
42
42
|
async function builder_default({
|
|
43
43
|
type: type2,
|
|
44
|
-
entryPoint,
|
|
44
|
+
entryPoint: entryPoint2,
|
|
45
45
|
inDir: inDir2,
|
|
46
46
|
outDir: outDir2,
|
|
47
|
-
outFile,
|
|
48
|
-
external = []
|
|
47
|
+
outFile: outFile2,
|
|
48
|
+
external: external2 = []
|
|
49
49
|
}) {
|
|
50
50
|
const messages2 = [];
|
|
51
51
|
assert.ok(
|
|
52
|
-
|
|
52
|
+
entryPoint2 === void 0 && outFile2 === void 0 || entryPoint2 !== void 0 && outFile2 !== void 0,
|
|
53
53
|
"entryPoint and outFile must both be provided"
|
|
54
54
|
);
|
|
55
55
|
const allSourceFiles = await getFiles(inDir2);
|
|
56
|
-
const productionSourceFiles =
|
|
56
|
+
const productionSourceFiles = entryPoint2 === void 0 ? allSourceFiles.filter((file) => file.endsWith(".ts")) : [path.join(inDir2, entryPoint2)];
|
|
57
57
|
const program = typescript.createProgram(productionSourceFiles, {
|
|
58
58
|
module: typescript.ModuleKind.ESNext,
|
|
59
59
|
moduleResolution: typescript.ModuleResolutionKind.Bundler,
|
|
@@ -111,7 +111,7 @@ async function builder_default({
|
|
|
111
111
|
format: type2 === "module" ? "esm" : "cjs",
|
|
112
112
|
sourcemap: "inline",
|
|
113
113
|
sourcesContent: false,
|
|
114
|
-
...
|
|
114
|
+
...outFile2 === void 0 ? {
|
|
115
115
|
outdir: outDir2,
|
|
116
116
|
outExtension: { ".js": type2 === "module" ? ".mjs" : ".cjs" },
|
|
117
117
|
plugins: [
|
|
@@ -120,7 +120,7 @@ async function builder_default({
|
|
|
120
120
|
setup: setup(type2)
|
|
121
121
|
}
|
|
122
122
|
]
|
|
123
|
-
} : { outfile: path.join(outDir2,
|
|
123
|
+
} : { outfile: path.join(outDir2, outFile2), external: external2 }
|
|
124
124
|
});
|
|
125
125
|
messages2.push(...buildResult.errors.map((error) => `esbuild error: ${error.text}`));
|
|
126
126
|
messages2.push(...buildResult.warnings.map((warning) => `esbuild warning: ${warning.text}`));
|
|
@@ -132,12 +132,15 @@ async function builder_default({
|
|
|
132
132
|
|
|
133
133
|
// src/builder/index.mts
|
|
134
134
|
var {
|
|
135
|
-
values: { type, inDir, outDir }
|
|
135
|
+
values: { type, inDir, outDir, entryPoint, outFile, external }
|
|
136
136
|
} = parseArgs({
|
|
137
137
|
options: {
|
|
138
138
|
type: { type: "string", short: "t", default: "module" },
|
|
139
139
|
inDir: { type: "string", short: "i", default: "src" },
|
|
140
|
-
outDir: { type: "string", short: "o", default: "build" }
|
|
140
|
+
outDir: { type: "string", short: "o", default: "build" },
|
|
141
|
+
entryPoint: { type: "string", short: "e", default: void 0 },
|
|
142
|
+
outFile: { type: "string", short: "f", default: void 0 },
|
|
143
|
+
external: { type: "string", short: "x", multiple: true, default: [] }
|
|
141
144
|
}
|
|
142
145
|
});
|
|
143
146
|
assert2.ok(type === "module" || type === "commonjs", "type must be module or commonjs");
|
|
@@ -146,7 +149,10 @@ assert2.ok(outDir !== void 0, "outDir is required");
|
|
|
146
149
|
var messages = await builder_default({
|
|
147
150
|
type,
|
|
148
151
|
inDir: path2.join(process.cwd(), inDir),
|
|
149
|
-
outDir: path2.join(process.cwd(), outDir)
|
|
152
|
+
outDir: path2.join(process.cwd(), outDir),
|
|
153
|
+
entryPoint,
|
|
154
|
+
outFile,
|
|
155
|
+
external
|
|
150
156
|
});
|
|
151
157
|
if (messages.length > 0) {
|
|
152
158
|
console.warn(JSON.stringify(messages, void 0, 2));
|
package/package.json
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"name":"@checkdigit/typescript-config","version":"3.3.0-PR.30-
|
|
1
|
+
{"name":"@checkdigit/typescript-config","version":"3.3.0-PR.30-d5d5","description":"Check Digit standard Typescript configuration","prettier":"@checkdigit/prettier-config","engines":{"node":">=16"},"bin":{"builder":"./bin/builder.mjs"},"peerDependencies":{"@types/node":">=16","esbuild":"0.17.19","typescript":">=5.0.4 <5.1"},"repository":{"type":"git","url":"git+https://github.com/checkdigit/typescript-config.git"},"author":"Check Digit, LLC","license":"MIT","bugs":{"url":"https://github.com/checkdigit/typescript-config/issues"},"homepage":"https://github.com/checkdigit/typescript-config#readme","scripts":{"preversion":"npm test","postversion":"git push && git push --tags","prepare":"npm run build-builder","lint:fix":"eslint -f unix --ext .ts,.mts src --fix","lint":"eslint -f unix --ext .ts,.mts src","prettier":"prettier --ignore-path .gitignore --list-different .","prettier:fix":"prettier --ignore-path .gitignore --write .","test":"npm run ci:compile && npm run ci:test && npm run ci:lint && npm run ci:style","build-builder":"esbuild src/builder/index.mts --bundle --platform=node --format=esm --external:typescript --external:esbuild --outfile=build-builder/builder.mjs && mkdir -p bin && { echo '#!/usr/bin/env node'; cat build-builder/builder.mjs; } > bin/builder.mjs && chmod +x bin/builder.mjs","build-cjs":"rimraf build-cjs && npx builder --type=commonjs --outDir=build-cjs","build-cjs-bundle":"rimraf build-cjs-bundle && npx builder --type=commonjs --entryPoint=test/index.test.ts --outDir=build-cjs-bundle --outFile=test/index.test.cjs","build-cjs-bundle-no-external":"rimraf build-cjs-bundle-no-external && npx builder --type=commonjs --external=./node_modules/* --entryPoint=test/index.test.ts --outDir=build-cjs-bundle-no-external --outFile=test/index.test.cjs","build-esm":"rimraf build-esm && npx builder --type=module --outDir=build-esm","build-esm-bundle":"rimraf build-esm-bundle && npx builder --type=module --outDir=build-esm-bundle --entryPoint=test/index.test.ts --outFile=test/index.test.mjs","build-esm-bundle-no-external":"rimraf build-esm-bundle-no-external && npx builder --type=module --external=./node_modules/* --outDir=build-esm-bundle-no-external --entryPoint=test/index.test.ts --outFile=test/index.test.mjs","test-jest-esm":"NODE_OPTIONS=\"--experimental-vm-modules\" jest --coverage=false src/*.mts src/*/*.mts src/*/*/*.mts","test-jest-cjs":"jest --coverage=false src/*.ts src/*/*.ts src/*/*/*.ts","test-cjs":"node --test build-cjs/test/index.test.cjs","test-cjs-bundle":"node --test build-cjs-bundle/test/index.test.cjs","test-cjs-bundle-no-external":"node --test build-cjs-bundle-no-external/test/index.test.cjs","test-esm":"node --test build-esm/test/index.test.mjs","test-esm-bundle":"echo \"node --test build-esm-bundle/test/index.test.mjs\"","test-esm-bundle-no-external":"node --test build-esm-bundle-no-external/test/index.test.mjs","ci:test":"npm run test-jest-cjs && npm run test-jest-esm && npm run test-cjs && npm run test-cjs-bundle && npm run test-cjs-bundle-no-external && npm run test-esm && npm run test-esm-bundle && npm run test-esm-bundle-no-external","ci:compile":"npm run build-builder && npm run build-cjs && npm run build-cjs-bundle && npm run build-cjs-bundle-no-external && npm run build-esm && npm run build-esm-bundle && npm run build-esm-bundle-no-external","ci:lint":"npm run lint","ci:style":"npm run prettier"},"devDependencies":{"@checkdigit/prettier-config":"^3.4.0","@types/debug":"^4.1.7","@types/jest":"^29.5.1","@types/uuid":"^9.0.1","@typescript-eslint/eslint-plugin":"^5.59.6","@typescript-eslint/parser":"^5.59.6","debug":"^4.3.4","eslint":"^8.40.0","eslint-config-prettier":"^8.8.0","get-port":"^6.1.2","got":"^11.8.6","jest":"^29.5.0","rimraf":"^5.0.1","ts-jest":"^29.1.0","uuid":"^9.0.0"},"eslintConfig":{"parser":"@typescript-eslint/parser","plugins":["@typescript-eslint"],"parserOptions":{"project":"./tsconfig.json"},"extends":["eslint:all","plugin:@typescript-eslint/recommended","plugin:@typescript-eslint/recommended-requiring-type-checking","plugin:@typescript-eslint/strict","prettier"],"rules":{"@typescript-eslint/non-nullable-type-assertion-style":"error","capitalized-comments":"off","one-var":"off","sort-keys":"off","sort-imports":"off","func-style":["error","declaration",{"allowArrowFunctions":true}],"no-magic-numbers":["error",{"ignore":[0,1,2]}],"no-undefined":"off","no-ternary":"off"},"overrides":[{"files":["*.spec.mts","*.test.mts","*.spec.ts","*.test.ts"],"rules":{"@typescript-eslint/non-nullable-type-assertion-style":"off","@typescript-eslint/ban-types":"off","@typescript-eslint/require-await":"off","@typescript-eslint/consistent-type-definitions":"off","@typescript-eslint/ban-ts-comment":"off","@typescript-eslint/no-unnecessary-condition":"off","@typescript-eslint/consistent-indexed-object-style":"off","@typescript-eslint/no-unused-vars":"off","@typescript-eslint/no-unsafe-member-access":"off","line-comment-position":"off","no-inline-comments":"off","no-param-reassign":"off","id-length":"off","no-magic-numbers":"off","func-names":"off","no-duplicate-imports":"off","symbol-description":"off","no-invalid-this":"off","max-lines-per-function":"off","max-lines":"off","max-statements":"off","no-await-in-loop":"off"}}]},"jest":{"moduleFileExtensions":["js","mjs","cjs","ts","mts","json","node"],"extensionsToTreatAsEsm":[".mts"],"transform":{"^.+\\.mts$":["ts-jest",{"isolatedModules":true,"diagnostics":false,"useESM":true}],"^.+\\.ts$":["ts-jest",{"isolatedModules":true,"diagnostics":false,"useESM":false}]},"collectCoverageFrom":["<rootDir>/src/**","!<rootDir>/src/**/*.spec.mts","!<rootDir>/src/**/*.test.mts","!<rootDir>/src/**/*.spec.ts","!<rootDir>/src/**/*.test.ts"],"testMatch":["<rootDir>/src/**/*.spec.ts","<rootDir>/src/**/*.spec.mts"]},"files":["tsconfig.json","SECURITY.md","/src/"]}
|
package/src/builder/builder.mts
CHANGED
|
@@ -17,7 +17,7 @@ export interface BuilderOptions {
|
|
|
17
17
|
* the entry point for the bundle, relative to the inDir. if not provided, the files in the inDir will be processed
|
|
18
18
|
* as individual unbundled files
|
|
19
19
|
*/
|
|
20
|
-
entryPoint?: string;
|
|
20
|
+
entryPoint?: string | undefined;
|
|
21
21
|
|
|
22
22
|
/**
|
|
23
23
|
* source code
|
|
@@ -32,12 +32,12 @@ export interface BuilderOptions {
|
|
|
32
32
|
/**
|
|
33
33
|
* build file, relative to the outDir
|
|
34
34
|
*/
|
|
35
|
-
outFile?: string;
|
|
35
|
+
outFile?: string | undefined;
|
|
36
36
|
|
|
37
37
|
/**
|
|
38
38
|
* external modules to exclude from the bundle
|
|
39
39
|
*/
|
|
40
|
-
external?: string[];
|
|
40
|
+
external?: string[] | undefined;
|
|
41
41
|
}
|
|
42
42
|
|
|
43
43
|
/**
|
package/src/builder/index.mts
CHANGED
|
@@ -9,12 +9,15 @@ import { parseArgs } from 'node:util';
|
|
|
9
9
|
import builder from './builder.mts';
|
|
10
10
|
|
|
11
11
|
const {
|
|
12
|
-
values: { type, inDir, outDir },
|
|
12
|
+
values: { type, inDir, outDir, entryPoint, outFile, external },
|
|
13
13
|
} = parseArgs({
|
|
14
14
|
options: {
|
|
15
15
|
type: { type: 'string', short: 't', default: 'module' },
|
|
16
16
|
inDir: { type: 'string', short: 'i', default: 'src' },
|
|
17
17
|
outDir: { type: 'string', short: 'o', default: 'build' },
|
|
18
|
+
entryPoint: { type: 'string', short: 'e', default: undefined },
|
|
19
|
+
outFile: { type: 'string', short: 'f', default: undefined },
|
|
20
|
+
external: { type: 'string', short: 'x', multiple: true, default: [] },
|
|
18
21
|
},
|
|
19
22
|
});
|
|
20
23
|
|
|
@@ -26,6 +29,9 @@ const messages = await builder({
|
|
|
26
29
|
type,
|
|
27
30
|
inDir: path.join(process.cwd(), inDir),
|
|
28
31
|
outDir: path.join(process.cwd(), outDir),
|
|
32
|
+
entryPoint,
|
|
33
|
+
outFile,
|
|
34
|
+
external,
|
|
29
35
|
});
|
|
30
36
|
if (messages.length > 0) {
|
|
31
37
|
// eslint-disable-next-line no-console
|