@tsmodule/tsmodule 8.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) C. Lewis <ctj.lewis@icloud.com> (ctjlewis.com)
+Copyright (c) Luke Edwards <luke.edwards05@gmail.com> (lukeed.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,136 @@
+<div align="center">
+  <h1><code>tsmodule</code></h1>
+  <h3>TypeScript Module Toolkit</h3>
+</div>
+
+## Features
+
+### Quickly create TypeScript projects with **`tsmodule create`**
+
+Supports React via TSX/JSX. Ready with zero config:
+
+  - package.json scripts: `yarn build`, `yarn test`, `yarn lint`
+  - ESLint, `typescript-eslint`, TypeScript configs
+  - CI/CD with GitHub Actions
+
+### Build TypeScript to pure ESM with **`tsmodule build`**
+
+  - No more polyfilling to CJS or older featuresets
+  - Use latest syntax in source, leave backporting to downstream consumers
+
+### Run TypeScript directly with **`tsmodule <file>`**
+
+  - Uses Node module loader to resolve TS at runtime
+  - Executable TypeScript files with `#!/usr/bin/env tsm`
+
+## Use Cases
+
+Below are some example use cases of TS modules in practice.
+
+### Generic TypeScript library
+
+The most common type of library will be a TS module with generic TypeScript
+exports in `src/**/index.ts`, e.g.
+[`await-shell`](https://github.com/ctjlewis/await-shell), a Promise wrapper
+around `child_process.spawn` that's used in tsmodule itself.
+
+This library contains only one export at `src/index.ts`, a function called
+`shell`. It has one test at `test/errors.test.ts`.
+
+### Next.js component library
+
+It's often necessary to compile libraries of TSX components to valid JS that can
+be consumed by a bundler downstream.  This is handled by tsmodule out of the
+box.
+
+The following configuration can be used to export a library of TSX components in
+`src/components/**/index.tsx` that is also consumed in a Next.js demo from pages
+in `src/pages`:
+
+- In `next.config.js`, allow for ESM externals (our exported components will be
+  ESM):
+
+    ```js
+    { 
+      experiments: { 
+        esmExternals: true 
+      } 
+    }
+    ```
+
+- In package.json, configure the package to export from `dist/components`:
+
+    ```json
+    {
+      "exports": {
+        ".": "./dist/index.js",
+        "./*": "./dist/components/*/index.js",
+        "./styles": "./dist/styles/index.css",
+        "./styles/*": "./dist/styles/*/index.css",
+        "./package.json": "./package.json"
+      },
+    }
+    ```
+
+## Requirements
+
+Because tsmodule packages are pure ESM environments, only **Node 16+** is
+supported.
+
+## Installation
+
+Install tsmodule in your project (or globally) to run or build your module:
+
+```shell
+yarn add @tsmodule/tsmodule
+```
+
+
+You can build your TypeScript module to ESM with the `build` CLI command:
+
+```shell
+tsmodule build
+```
+
+Source will be compiled from `src/` to `dist/` and will contain only
+ESM-compliant import specifiers as resolved by the tsmodule loader. It can then
+be executed with Node, e.g. `node dist/index.js`.
+
+## Footnotes
+
+### Module configuration
+
+All packages built with `tsmodule build` are ES modules. `{ "type": "module" }`
+is forced to minimize ambiguity.
+
+`tsmodule build` also forces the following tsconfig.json values during the
+type-check and declaration emit:
+
+```json
+{
+  "rootDir": "src/",
+  "outDir": "dist/",
+}
+```
+
+And conditional exports in package.json will be configured like so, such that
+"index modules" at e.g. `src/test/index.ts` will be available at
+`my-package/test`:
+
+```json
+{
+  "files": ["dist/"],
+  "exports": {
+    "./package.json": "./package.json",
+    "./": "./dist/index.js",
+    "./*": "./dist/*/index.js"
+  },
+}
+```
+
+This has no restriction on internal imports between files, only the default
+configuration for how downstream consumers can import from module subpaths.
+
+## License
+
+MIT © [C. Lewis](https://ctjlewis.com)

package/dist/commands/build/index.d.ts

@@ -0,0 +1,7 @@
+export declare const bannerLog: (msg: string) => void;
+/**
+ * Build TS to JS. This will contain incomplete specifiers like `./foo` which
+ * could mean many things, all of which is handled by the loader which will
+ * resolve them for us.
+ */
+export declare const build: (dev?: boolean) => Promise<void>;

package/dist/commands/build/index.js

@@ -0,0 +1,3 @@
+import{build as d}from"esbuild";import{existsSync as h,readFileSync as k,writeFileSync as T}from"fs";import{extname as w,resolve as l}from"path";import{readFile as x,rm as F}from"fs/promises";import a from"chalk";import O from"fast-glob";import{createDebugLogger as B,log as c}from"create-debug-logger";import{isTs as N,isTsxOrJsx as g}from"../../utils/index.js";import{emitTsDeclarations as j}from"./lib/emitTsDeclarations.js";import{normalizeImportSpecifiers as E}from"../normalize/index.js";import i from"ora";const y=t=>{c(a.bgBlue(a.white(`  ${t}  `)))},J=async(t=!1)=>{const n=B(J);t||y("Building for production.");const s=process.cwd(),S=l(s,"package.json"),b=await x(S,"utf-8"),m={absWorkingDir:s,outbase:"src",outdir:"dist",assetNames:"[name].js",logLevel:t?"debug":"error",charset:"utf8",format:"esm",target:"esnext",minify:!t,define:{PACKAGE_JSON:b}},f=l(s,"dist");n.log("Cleaning old output:",{distDir:f}),await F(f,{force:!0,recursive:!0});const r=O.sync("src/**/*",{cwd:s}).filter(e=>w(e)!==".d.ts").map(e=>l(e)),p=r.filter(e=>N.test(e)).filter(e=>!g.test(e));n.log("Compiling TS files:",{tsFiles:p}),await d({...m,entryPoints:p.filter(e=>!e.endsWith(".d.ts"))}),i("Built TS files.").succeed();const u=r.filter(e=>g.test(e));if(n.log("Compiling TSX files:",{tsxFiles:u}),await d({...m,entryPoints:u.filter(e=>!e.endsWith(".d.ts")),jsxFactory:"createElement",banner:{js:`import { createElement } from 'react';
+`}}),i("Built TSX files.").succeed(),process.env.NO_REWRITES||(await E(),i("Normalized import specifiers.").succeed(),t)||process.env.NO_DECLARATIONS)return;y("Running post-build setup."),c(`Generating type declarations.
+This might take a moment.`),j(r),i(`Generated delcarations for ${r.length} files.`).succeed();let o;h("dist/package.json")?o=JSON.parse(k("dist/package.json","utf-8")):o={},o.type="module",T("dist/package.json",JSON.stringify(o,null,2)),i('Forced "type": "module" in output.').succeed(),c(a.green("Build complete."))};export{y as bannerLog,J as build};

package/dist/commands/build/lib/emitTsDeclarations.d.ts

@@ -0,0 +1 @@
+export declare const emitTsDeclarations: (files: string[]) => void;

package/dist/commands/build/lib/emitTsDeclarations.js

@@ -0,0 +1,3 @@
+import{TS_CONFIG as m}from"../../normalize/lib/typescriptApi.js";import a from"chalk";import{createDebugLogger as g}from"create-debug-logger";import t from"typescript";const f=o=>{const r=g(f),s=t.createProgram(o,{...m,declaration:!0,noEmit:!1,emitDeclarationOnly:!0}),i=s.emit();t.getPreEmitDiagnostics(s).concat(i.diagnostics).forEach(e=>{if(e.file){const{line:n,character:l}=t.getLineAndCharacterOfPosition(e.file,e.start??0),c=t.flattenDiagnosticMessageText(e.messageText,`
+`);r.log(a.red(`${e.file.fileName} (${n+1},${l+1}): ${c}`))}else r.log(a.red(t.flattenDiagnosticMessageText(e.messageText,`
+`)))})};export{f as emitTsDeclarations};

package/dist/commands/create/index.d.ts

@@ -0,0 +1 @@
+export declare const create: (name: string) => Promise<void>;

package/dist/commands/create/index.js

@@ -0,0 +1 @@
+import{cp as p,readFile as d,writeFile as g}from"fs/promises";import{fileURLToPath as m,URL as u}from"url";import w from"chalk";import f from"ora";import{resolve as a}from"path";import{shell as n}from"await-shell";const S=async e=>{const i=process.cwd(),t=f(`Creating new module ${w.blueBright(e)}.`).start(),o=new u("../../../template",import.meta.url);await p(m(o),a(i,e),{recursive:!0});const s=a(i,e,"package.json"),c=await d(s,"utf-8"),r=JSON.parse(c);r.name=e,await g(s,JSON.stringify(r,null,2)),t.succeed("Project created."),t.start("Installing dependencies."),process.chdir(e);const l=["@tsmodule/tsmodule","typescript","ava","eslint","@typescript-eslint/eslint-plugin","@typescript-eslint/parser"];globalThis.SHELL_OPTIONS={stdio:["ignore","ignore","inherit"]},await n(`yarn add -D ${l.join(" ")}`),t.succeed("Dependencies installed."),t.start("Initializing git."),await n("git init"),t.succeed("Git initialized.")};export{S as create};

package/dist/commands/execute/index.d.ts

@@ -0,0 +1 @@
+export declare const execute: () => void;

package/dist/commands/execute/index.js

@@ -0,0 +1 @@
+import{URL as s}from"url";import{spawn as n}from"child_process";const a=()=>{process.env.NODE_OPTIONS="--no-warnings";const e=import.meta.url,o=new s("../../../dist/loader/index.js",e),r=["--loader",o.href,...process.argv.slice(2)];n("node",r,{stdio:"inherit"}).on("exit",process.exit)};export{a as execute};

package/dist/commands/normalize/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview
+ * This module contains the logic for normalizing import specifiers. It must use
+ * fully-specified filepaths here, since the bootstrap script will compile it
+ * with esbuild and then use it to normalize emitted output.
+ */
+/**
+ * Matches a complete import statement, including the import keyword, as well as
+ * dynamic imports, requires, and export statements.
+ */
+export declare const generateImportPattern: (importSource: string) => RegExp;
+/**
+ * Rewrite an import/export/require statement.
+ */
+export declare const rewriteImportStatement: (importStatement: string, specifierToReplace: string, specifierReplacement: string) => string;
+/**
+ * Rewrite imports in the emitted JS to ESM-compliant paths.
+ */
+export declare const normalizeImportSpecifiers: (files?: string) => Promise<any>;

package/dist/commands/normalize/index.js

@@ -0,0 +1,2 @@
+import{readFile as w,writeFile as $}from"fs/promises";import x from"fast-glob";import{pathToFileURL as E}from"url";import{resolve as y}from"path";import{createDebugLogger as g}from"create-debug-logger";import{getRewrittenSpecifiers as I}from"./lib/typescriptApi.js";const P=e=>{const r=`[^
+\r;]*`,o=e.replace(".","\\.").replace("/","\\/"),s=`${r}["']${o}["']${r}`,t=`(import${r}from)`,i=`(import|require)${r}\\(`,n=`(export${r}from)`;return new RegExp(`(${t}|${i}|${n})${s}`,"g")},d=(e,r,o)=>{g(d).log("Rewriting import",{importStatement:e,specifierToReplace:r,specifierReplacement:o});const[,t]=e.split(/from|\(/),i=t.replace(r,o).trim();return e.replace(t,i)},R=async(e="dist/**/*.js")=>{const r=g(R),o=await x(e,{cwd:process.cwd()});r.log("Normalizing import/require specifiers:",{filesToNormalize:o});for(const s of o){const t=y(s),i=E(t).href,n=I(t);if(!n)return null;r.log("TypeScript API yielded specifiers to rewrite:",{rewrites:n});let p=await w(t,"utf8");r.group();for(const{specifierToReplace:c,specifierReplacement:a}of n){const u=P(c),l=p.match(u)??[];r.log("Replacing import statements.",{entryPointURL:i,specifierToReplace:c,specifierReplacement:a,importStatements:l});for(const m of l){r.group();const f=d(m,c,a);r.log("Performing specifier rewrite.",{entryPointURL:i,importStatement:m,rewrittenImportStatement:f}),p=p.replace(m,f),await $(t,p),r.log("Wrote output file.",{resolvedEntryPoint:t}),r.groupEnd()}}r.groupEnd()}};export{P as generateImportPattern,R as normalizeImportSpecifiers,d as rewriteImportStatement};

package/dist/commands/normalize/lib/typescriptApi.d.ts

@@ -0,0 +1,13 @@
+import ts from "typescript";
+export declare const TS_CONFIG: ts.CompilerOptions;
+export declare const compilerHost: ts.CompilerHost;
+interface SpecifierReplacement {
+    specifierToReplace: string;
+    specifierReplacement: string;
+}
+/**
+ * Get the rewritten specifiers for a given module. Import/export specifiers
+ * will be resolved ahead-of-time by the TypeScript compiler and returned.
+ */
+export declare const getRewrittenSpecifiers: (modulePath: string) => SpecifierReplacement[];
+export {};

package/dist/commands/normalize/lib/typescriptApi.js

@@ -0,0 +1 @@
+import{dirname as E,extname as v,relative as w}from"path/posix";import{createDebugLogger as N}from"create-debug-logger";import e from"typescript";const l={moduleResolution:e.ModuleResolutionKind.NodeJs,module:e.ModuleKind.ESNext,target:e.ScriptTarget.ESNext,esModuleInterop:!0,incremental:!1,noEmit:!0,rootDir:"src",outDir:"dist"},p=e.createCompilerHost(l),R=(t,o=process.cwd())=>{const{resolvedModule:r}=e.resolveModuleName(t,o,l,p);if(!r){const s=JSON.stringify({specifier:t,entryPoint:o},null,2);throw new Error(`Could not resolve module: ${s}`)}return r},x=(t,o)=>{const r=w(E(t),o);return r.startsWith(".")?r:`./${r}`},h=t=>{const o=N(h);o.log("Getting rewritten specifiers:",{modulePath:t});const{resolvedFileName:r}=R(t),s=p.getSourceFile(r,e.ScriptTarget.ESNext);if(!s)throw new Error(`Could not read source file: ${r}`);const{statements:d,fileName:u}=s,a=[];return d.forEach(n=>{const f=e.isExportDeclaration(n);if(!(e.isImportDeclaration(n)&&!n?.importClause?.isTypeOnly)&&!f)return;const{moduleSpecifier:c}=n;if(!c){if(f)return;throw new Error(`Could not find module specifier in: ${JSON.stringify(n)}`)}if(e.isStringLiteral(c)){const{text:i}=c;if(!i.startsWith(".")||v(i))return;o.log("Using TypeScript API to resolve specifier",{specifier:i});const{resolvedModule:m}=e.resolveModuleName(i,u,{...l,allowJs:!0,checkJs:!0},p);if(!m)throw new Error(`Could not resolve module: ${i}`);const{resolvedFileName:g}=m,S=x(u,g);a.push({specifierToReplace:i,specifierReplacement:S})}}),a};export{l as TS_CONFIG,p as compilerHost,h as getRewrittenSpecifiers};

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+var t="@tsmodule/tsmodule",r="module",a="8.1.0",s="tsmodule/tsmodule",d="TypeScript Module loader and compiler",m="MIT",c={tsmodule:"dist/index.js"},p={".":"./dist/loader/index.js","./*":"./dist/*/index.js","./package.json":"./package.json"},l="dist/types/index.d.ts",f=[{name:"C. Lewis",email:"ctj.lewis@icloud.com",url:"https://ctjlewis.com"}],u=["dist/","template/"],v={node:">=14"},g={bootstrap:"node bootstrap.js",prebuild:"yarn bootstrap",build:"node --no-warnings --loader ./dist/loader/index.js src/index.ts build",lint:"eslint --fix src",prepare:"yarn build",test:"ava --no-worker-threads"},S={"await-shell":"^2.7.0",chalk:"^5.0.0",commander:"^8.3.0","create-debug-logger":"^1.10.1",esbuild:"^0.14.0","fast-glob":"^3.2.10",ora:"^6.0.1",react:"^17.0.2",rollup:"^2.63.0","rollup-plugin-preserve-shebang":"^1.0.1",typescript:"^4.5.5"},w={"@types/node":"17.0.8","@types/react":"17.0.38","@typescript-eslint/eslint-plugin":"^5.9.1","@typescript-eslint/parser":"^5.9.1",ava:"^4.0.1",eslint:"^8.6.0"},C=["esm","loader","typescript","loader hook","require hook","experimental-loader"],b={files:["test/**/*.test.ts"],extensions:{ts:"module"},nodeArguments:["--no-warnings","--loader=@tsmodule/tsmodule"]},n={name:t,type:r,version:a,repository:s,description:d,license:m,bin:c,exports:p,types:l,contributors:f,files:u,engines:v,scripts:g,dependencies:S,devDependencies:w,keywords:C,ava:b};import{Command as A}from"commander";import{build as E}from"./commands/build/index.js";import{create as h}from"./commands/create/index.js";import{execute as x}from"./commands/execute/index.js";import{normalizeImportSpecifiers as y}from"./commands/normalize/index.js";const o=new A;o.command("execute <file>",{isDefault:!0}).option("--d, --dev","Enable development mode").description("Run the given TS program, analogous to `node <file>`.").action(x),o.command("build").option("-d, --dev","Build development version (default: production)").description("Builds TS files to output in dist/. (default: src/**/*.{ts,tsx})").action(async({dev:i})=>await E(i)),o.command("create <name>").description("Create a new project.").action(h),o.command("normalize [files]").description(`Rewrites import specifiers in files to ESM-compliant paths.
+(default: dist/**/*.js)`).action(async({files:i})=>{await y(i)}),o.command("version").description("Print the current version.").action(()=>{console.log(typeof n=="undefined"?"Cannot read version in development mode.":`v${n.version}`)}),o.parse(process.argv);

package/dist/loader/index.d.ts

@@ -0,0 +1,11 @@
+import type { GetFormatHook as ModuleGetFormatHook, LoadHook as ModuleLoadHook, ResolveHook as ModuleResolveHook, TransformHook as ModuleTransformSourceHook } from "./types";
+export declare const resolve: ModuleResolveHook;
+export declare const load: ModuleLoadHook;
+/**
+ * @deprecated As of Node 17.
+ */
+export declare const getFormat: ModuleGetFormatHook;
+/**
+ * @deprecated As of Node 17.
+ */
+export declare const transformSource: ModuleTransformSourceHook;

package/dist/loader/index.js

@@ -0,0 +1 @@
+import{extname as m,isAbsolute as U,join as F,normalize as E,resolve as S}from"path";import{fileURLToPath as w,pathToFileURL as v,URL as L}from"url";import{promises as H}from"fs";import{transform as h}from"esbuild";import{sep as M}from"path/posix";import{sep as T}from"path/win32";import{checkExtensions as k,checkTsExtensions as D,fileExists as b,isJs as G,isTs as y,MODULE_LOADERS as R}from"../utils/index.js";import{createDebugLogger as d}from"create-debug-logger";const N=async(o,r,t)=>{const{parentURL:s}=r,e=d(N);if(e.log("Resolving specifier:",{importedFromURL:s,specifier:o}),!o.startsWith(".")&&!U(o))return e.log("Using defaultResolve for named module:",{specifier:o}),t(o,r,t);const{href:l}=v(process.cwd()),{href:i}=new L(s||l);e.log("Finding import URL for",{specifier:o,baseURL:i});let n=o;o.startsWith("file://")||(U(o)?(e.log("Setting import URL to absolute specifier."),n=v(S(E(o))).href):(e.log("Setting import URL relative to baseURL."),n=new L(o,i).href),e.log("Resolved import URL:",{importedFileURL:n,importedFromURL:s}));const f=m(s??"").toLowerCase(),u=m(n).toLowerCase();if(e.log("Rewriting file extension:",{parentExtension:f,specifierExtension:u}),u){const a=n.substring(0,n.lastIndexOf(u));if(e.log("Re-resolving specifier:",{unresolvedSpecifier:a}),G.test(u)&&y.test(f)){const p=D(a);if(p)return e.log("Found JS import in TS:",{unresolvedSpecifier:a,resolvedTsSourceFile:p}),{url:p}}return b(a)?(e.log("Found file at unresolved specifier:",{unresolvedSpecifier:a}),{url:a}):t(o,r,t)}e.log("Resolving incomplete URL import to file:",{specifier:o});const c=k(n);if(c)return e.log("Resolved import URL to file:",{resolvedFile:c}),{url:c};const x=new L(F(n,"index")).href,g=k(x);return g?(e.log("Resolved import URL to index file:",{resolvedIndexFile:g}),{url:g}):t(o,r,t)},B=async(o,r,t)=>{const s=d(B);if(s.log("Loading source file:",{url:o}),!o.includes(T)&&!o.includes(M))return s.log("Using defaultLoad for named module:",{url:o}),t(o,r,t);const e=m(o),l=R[e];if(!l)return s.log("No loader found, using defaultLoad:",{url:o}),t(o,r,t);const i=w(o),n=await H.readFile(i),f=await h(n.toString(),{...l,sourcefile:i,format:"esm"});return{format:"module",source:f.code}},O=async(o,r,t)=>{const s=d(O);s.log("Getting format for source file:",{url:o});const e=m(o);return R[e]?{format:"module"}:(s.log("No loader found, using default format:",{url:o}),t(o,r,t))},j=async(o,r,t)=>{const s=d(j);s.log("Transforming source from context:",{context:r});const{url:e}=r,l=m(e),i=R[l];return i?{source:(await h(o.toString(),{...i,logLevel:"info",charset:"utf8",target:"esnext",sourcefile:r.url,format:r.format==="module"?"esm":"cjs"})).code}:(s.log("No loader found, using default transformer:",{url:e}),t(o,r,t))};export{O as getFormat,B as load,N as resolve,j as transformSource};

package/dist/loader/types.d.ts

@@ -0,0 +1,22 @@
+export declare type Promisable<T> = Promise<T> | T;
+export declare type ModuleSource = string | SharedArrayBuffer | Uint8Array;
+export declare type ModuleFormat = "builtin" | "commonjs" | "json" | "module" | "wasm";
+export declare type ResolveHook = (specifier: string, context: {
+    conditions: string[];
+    parentURL?: string;
+}, fallback: ResolveHook) => Promisable<{
+    url: string;
+    format?: ModuleFormat;
+}>;
+export declare type GetFormatHook = (url: string, context: object, fallback: GetFormatHook) => Promisable<{
+    format: ModuleFormat;
+}>;
+export declare type TransformHook = (source: ModuleSource, context: Record<"url" | "format", string>, fallback: TransformHook) => Promisable<{
+    source: ModuleSource;
+}>;
+export declare type LoadHook = (url: string, context: {
+    format?: ModuleFormat;
+}, fallback: LoadHook) => Promisable<{
+    format: ModuleFormat;
+    source: ModuleSource;
+}>;

package/dist/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+declare global {
+    const PACKAGE_JSON: Record<string, unknown>;
+}
+export * from "../loader/types";

package/dist/types/index.js

@@ -0,0 +1 @@
+export*from"../loader/types.js";

package/dist/utils/index.d.ts

@@ -0,0 +1,27 @@
+export declare const DEVELOPMENT_MODE: boolean;
+export declare const isTs: RegExp;
+export declare const isJs: RegExp;
+export declare const isTsxOrJsx: RegExp;
+export declare const BASE_CONFIG: {
+    format: string;
+    charset: string;
+    sourcemap: string;
+    target: string;
+    minify: boolean;
+};
+export declare type ModuleLoaders = {
+    [extension: string]: {
+        [configKey: string]: unknown;
+    };
+};
+export declare const MODULE_LOADERS: ModuleLoaders;
+export declare const POSSIBLE_EXTENSIONS: string[];
+/**
+ * Force a Unix-like path.
+ */
+export declare const normalizeSpecifier: (path: string) => string;
+export declare const fileExists: (fileUrl: string) => string | void;
+export declare const fileExistsAny: (fileUrls: string[]) => string | void;
+export declare const checkTsExtensions: (specifier: string) => string | void;
+export declare const checkJsExtension: (specifier: string) => string | void;
+export declare const checkExtensions: (specifier: string) => string;

package/dist/utils/index.js

@@ -0,0 +1 @@
+import{existsSync as i}from"fs";import{fileURLToPath as c}from"url";import{sep as p}from"path/posix";import{sep as x}from"path";const O=!1,S=/\.[mc]?tsx?(?=\?|$)/,h=/\.([mc])?js$/,L=/\.([mc])?[tj]sx$/,e={format:"esm",charset:"utf8",sourcemap:"inline",target:"node16",minify:!1},a={".mts":{...e,loader:"ts"},".jsx":{...e,loader:"jsx"},".tsx":{...e,loader:"tsx"},".cts":{...e,loader:"ts"},".ts":{...e,loader:"ts"},".json":{...e,loader:"json"}},n=Object.keys(a),M=s=>s.split(x).join(p),l=s=>{const t=c(s);if(i(t))return s},r=s=>{for(const t of s)if(l(t))return t},m=s=>{const t=n.filter(o=>o.includes("ts")).concat([".js"]);return r(t.map(o=>s+o))},f=s=>{const t=n.filter(o=>o.includes("js")).concat([".js"]);return r(t.map(o=>s+o))},y=s=>{const t=f(s);if(t)return t;const o=m(s);if(o)return o};export{e as BASE_CONFIG,O as DEVELOPMENT_MODE,a as MODULE_LOADERS,n as POSSIBLE_EXTENSIONS,y as checkExtensions,f as checkJsExtension,m as checkTsExtensions,l as fileExists,r as fileExistsAny,h as isJs,S as isTs,L as isTsxOrJsx,M as normalizeSpecifier};

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@tsmodule/tsmodule",
+  "type": "module",
+  "version": "8.1.0",
+  "repository": "tsmodule/tsmodule",
+  "description": "TypeScript Module loader and compiler",
+  "license": "MIT",
+  "bin": {
+    "tsmodule": "dist/index.js"
+  },
+  "exports": {
+    ".": "./dist/loader/index.js",
+    "./*": "./dist/*/index.js",
+    "./package.json": "./package.json"
+  },
+  "types": "dist/types/index.d.ts",
+  "contributors": [
+    {
+      "name": "C. Lewis",
+      "email": "ctj.lewis@icloud.com",
+      "url": "https://ctjlewis.com"
+    }
+  ],
+  "files": [
+    "dist/",
+    "template/"
+  ],
+  "engines": {
+    "node": ">=14"
+  },
+  "scripts": {
+    "bootstrap": "node bootstrap.js",
+    "prebuild": "yarn bootstrap",
+    "build": "node --no-warnings --loader ./dist/loader/index.js src/index.ts build",
+    "lint": "eslint --fix src",
+    "prepare": "yarn build",
+    "test": "ava --no-worker-threads"
+  },
+  "dependencies": {
+    "await-shell": "^2.7.0",
+    "chalk": "^5.0.0",
+    "commander": "^8.3.0",
+    "create-debug-logger": "^1.10.1",
+    "esbuild": "^0.14.0",
+    "fast-glob": "^3.2.10",
+    "ora": "^6.0.1",
+    "react": "^17.0.2",
+    "rollup": "^2.63.0",
+    "rollup-plugin-preserve-shebang": "^1.0.1",
+    "typescript": "^4.5.5"
+  },
+  "devDependencies": {
+    "@types/node": "17.0.8",
+    "@types/react": "17.0.38",
+    "@typescript-eslint/eslint-plugin": "^5.9.1",
+    "@typescript-eslint/parser": "^5.9.1",
+    "ava": "^4.0.1",
+    "eslint": "^8.6.0"
+  },
+  "keywords": [
+    "esm",
+    "loader",
+    "typescript",
+    "loader hook",
+    "require hook",
+    "experimental-loader"
+  ],
+  "ava": {
+    "files": [
+      "test/**/*.test.ts"
+    ],
+    "extensions": {
+      "ts": "module"
+    },
+    "nodeArguments": [
+      "--no-warnings",
+      "--loader=@tsmodule/tsmodule"
+    ]
+  }
+}

package/template/.eslintrc

@@ -0,0 +1,52 @@
+{
+  "extends": [
+    "plugin:@typescript-eslint/recommended"
+  ],
+  "parser": "@typescript-eslint/parser",
+  "plugins": ["@typescript-eslint"],
+  "rules": {
+    
+    "no-console": "error",
+    "no-trailing-spaces": "error",
+    "max-len": [1, 80, 2, {
+      "ignorePattern": "^import\\s.+\\sfrom\\s.+;$",
+      "ignoreUrls": true,
+      "ignoreStrings": true,
+      "ignoreTemplateLiterals": true,
+      "ignoreRegExpLiterals": true
+    }],
+
+    "@typescript-eslint/type-annotation-spacing": ["error"],
+
+    "@typescript-eslint/ban-ts-comment": [
+      "error",
+      {
+        "ts-nocheck": "allow-with-description",
+        "ts-ignore": "allow-with-description"
+      }
+    ],
+
+    "indent": "off",
+    "@typescript-eslint/indent": ["error", 2],
+
+    "semi": "off",
+    "@typescript-eslint/semi": ["error", "always"],
+
+    "quotes": "off",
+    "@typescript-eslint/quotes": ["error", "double"],
+
+    "object-curly-spacing": "off",
+    "@typescript-eslint/object-curly-spacing": ["error", "always"],
+
+    "sort-imports": [
+      "warn",
+      {
+        "ignoreCase": false,
+        "ignoreDeclarationSort": false,
+        "ignoreMemberSort": true,
+        "memberSyntaxSortOrder": ["none", "all", "multiple", "single"],
+        "allowSeparatedGroups": true
+      }
+    ]
+  }
+}

package/template/.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - '**'
+  pull_request:
+    branches:
+      - '**'
+
+jobs:
+  test:
+    name: Node.js v${{ matrix.nodejs }} (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 5
+    strategy:
+      matrix:
+        nodejs: [16]
+        os: [ubuntu-latest, windows-latest, macos-latest]
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-node@v2
+      with:
+        node-version: ${{ matrix.nodejs }}
+
+    - name: Install and link
+      run: yarn install --frozen-lockfile && yarn build
+
+    - name: Test
+      run: yarn test

package/template/.gitignore

@@ -0,0 +1,10 @@
+node_modules
+
+# Potential Firebase / GCP credentials.
+service-account.json
+
+# Emitted output.
+dist/
+
+# Incremental TS build info.
+*.tsbuildinfo

package/template/README.md

@@ -0,0 +1,5 @@
+This is a TS module. Build it with tsmodule via:
+
+```shell
+yarn build
+```

package/template/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "template",
+  "type": "module",
+  "version": "0.0.1",
+  "license": "MIT",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    ".": "./dist/index.js",
+    "./*": "./dist/*/index.js"
+  },
+  "scripts": {
+    "build": "tsmodule build",
+    "test": "ava",
+    "lint": "eslint src --fix"
+  },
+  "ava": {
+    "files": [
+      "test/**/*.test.ts"
+    ],
+    "extensions": {
+      "ts": "module"
+    },
+    "nodeArguments": [
+      "--no-warnings",
+      "--loader=@tsmodule/tsmodule"
+    ]
+  }
+}

package/template/src/index.ts

@@ -0,0 +1,4 @@
+export const helloWorld = () => {
+  // eslint-disable-next-line no-console
+  console.log("Hello World!");
+};

package/template/test/example.test.ts

@@ -0,0 +1,7 @@
+import test from "ava";
+
+test("two plus two should equal four", (t) => {
+  if (2 + 2 === 4) {
+    t.pass();
+  }
+});

package/template/tsconfig.json

@@ -0,0 +1,41 @@
+{
+  "include": [
+    "*env.d.ts",
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "test/**"
+  ],
+  "compilerOptions": {
+    "moduleResolution": "Node",
+    "target": "ESNext",
+    "module": "ESNext",
+    "lib": [
+      "DOM",
+      "DOM.Iterable",
+      "ESNext"
+    ],
+    "jsx": "preserve",
+    "rootDir": "src",
+    "outDir": "dist",
+    "allowJs": true,
+    "importHelpers": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "sourceMap": true,
+    "checkJs": true,
+    "noEmit": false,
+    "forceConsistentCasingInFileNames": true,
+    "isolatedModules": true,
+    "incremental": false
+  }
+}