@openload28/create-tt 1.0.0-dev.20260902.311 → 1.0.0-dev.20260903.321

package/README.md

@@ -6,6 +6,10 @@ Create a ready-to-run Vite + TypeScript + tt project:
 bunx @openload28/create-tt@next my-app
 ```
 
+Generated projects declare `@openload28/tt-lang` as a TypeScript 7.1 content
+mapper and run `tsc` with `--runExternalCode`. `.ts` and `.tsx` files can import
+`.tt` and `.ttx` directly without `.tt-types` sidecars.
+
 Add tt to an existing TypeScript project. The initializer detects Vite,
 Rollup, Rolldown, webpack, Rspack, esbuild, or Farm from `package.json`:
 
@@ -15,7 +19,9 @@ bunx @openload28/create-tt@next init
 
 The initializer updates `package.json` structurally. For bundlers with a
 declarative config, it generates an `tt.*.config.mjs` wrapper instead of
-rewriting arbitrary user code. Existing scripts and config files stay intact.
+rewriting arbitrary user code. It also creates `tsconfig.tt.json`, which extends
+the existing TypeScript config and declares the content mapper. Existing scripts
+and config files stay intact.
 Use `--no-install` in CI or when dependencies will be installed later.
 New projects use Bun for dependency installation and scripts. Existing projects
 keep the package manager declared in `package.json` or selected by their lockfile.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openload28/create-tt",
-  "version": "1.0.0-dev.20260902.311",
+  "version": "1.0.0-dev.20260903.321",
   "description": "Create a new tt project or add tt to an existing TypeScript project",
   "license": "MIT",
   "publishConfig": {
@@ -17,7 +17,8 @@
     "README.md"
   ],
   "scripts": {
-    "test": "node --test"
+    "test": "node --test test/*.test.mjs",
+    "test:e2e": "node --test e2e/*.test.mjs"
   },
   "engines": {
     "node": ">=18"

package/src/installer.js

@@ -107,8 +107,8 @@ export async function createProject(options) {
     type: 'module',
     scripts: {
       dev: 'vite',
-      build: 'ttc --check-types src && vite build',
-      check: 'ttc --check-types src',
+      build: 'tsc -p tsconfig.json --runExternalCode && vite build',
+      check: 'tsc -p tsconfig.json --runExternalCode',
     },
     devDependencies: {
       '@openload28/tt-lang': versions['@openload28/tt-lang'],
@@ -123,7 +123,7 @@ export async function createProject(options) {
   await writeFile(join(root, 'index.html'), indexHtml)
   await writeFile(join(root, 'src/main.ts'), "import './app.tt'\n")
   await writeFile(join(root, 'src/app.tt'), starterSource)
-  await writeFile(join(root, '.gitignore'), 'node_modules/\ndist/\n.tt-types/\n')
+  await writeFile(join(root, '.gitignore'), 'node_modules/\ndist/\n')
   if (options.registry) {
     await writeFile(join(root, 'bunfig.toml'), `[install]\nregistry = ${JSON.stringify(options.registry)}\n`)
   }
@@ -144,7 +144,11 @@ export async function initializeExisting(options) {
   devDependencies.typescript ??= versions.typescript
   manifest.devDependencies = devDependencies
   manifest.scripts ??= {}
-  manifest.scripts['tt:check'] ??= 'ttc --check-types src'
+  const typeConfig = 'tsconfig.tt.json'
+  manifest.scripts['tt:check'] ??= `tsc -p ${typeConfig} --runExternalCode`
+
+  const baseConfig = existsSync(join(root, 'tsconfig.json')) ? './tsconfig.json' : undefined
+  await writeJson(join(root, typeConfig), tsconfig(baseConfig))
 
   const files = []
   let manualModule
@@ -159,13 +163,14 @@ export async function initializeExisting(options) {
       await writeFile(join(root, adapter.wrapper), wrapperConfig(adapter.module, base))
       files.push(adapter.wrapper)
       manifest.scripts['tt:dev'] ??= `${adapter.commands.dev} --config ${adapter.wrapper}`
-      manifest.scripts['tt:build'] ??= `ttc --check-types src && ${adapter.commands.build} --config ${adapter.wrapper}`
+      manifest.scripts['tt:build'] ??= `tsc -p ${typeConfig} --runExternalCode && ${adapter.commands.build} --config ${adapter.wrapper}`
     }
   } else {
     manifest.scripts['tt:build'] ??= 'ttc -o .tt-build src'
   }
 
   await writeJson(manifestPath, manifest, indentation(source))
+  files.push(typeConfig)
   return { root, packageManager, mode: 'init', bundler: bundler ?? 'none', files, manualModule }
 }
 
@@ -269,18 +274,26 @@ export default typeof base === 'function'
 `
 }
 
-function tsconfig() {
-  return {
-    compilerOptions: {
-      target: 'ES2022',
-      module: 'Preserve',
-      moduleResolution: 'Bundler',
-      strict: true,
-      noEmit: true,
-      skipLibCheck: true,
-    },
-    include: ['src', 'vite.config.ts'],
+function tsconfig(extendsConfig) {
+  const config = {
+    ...(extendsConfig
+      ? { extends: extendsConfig, compilerOptions: { noEmit: true } }
+      : {
+          compilerOptions: {
+            target: 'ES2022',
+            module: 'Preserve',
+            moduleResolution: 'Bundler',
+            strict: true,
+            noEmit: true,
+            skipLibCheck: true,
+          },
+          include: ['src', 'vite.config.ts'],
+        }),
+    contentMappers: [
+      { package: '@openload28/tt-lang', extensions: ['.tt', '.ttx'] },
+    ],
   }
+  return config
 }
 
 function packageName(value) {