From b8db8d645ee47980c034b104cc59bc22db7dc6c8 Mon Sep 17 00:00:00 2001
From: Marco Ippolito <marcoippolito54@gmail.com>
Date: Mon, 8 Jul 2024 13:50:17 +0200
Subject: [PATCH] doc: add strip-types proposal

---
 .DS_Store                          | Bin 0 -> 6148 bytes
 doc/.DS_Store                      | Bin 0 -> 6148 bytes
 doc/design/proposal-strip-types.md |  71 +++++++++++++++++++++++++++++
 3 files changed, 71 insertions(+)
 create mode 100644 .DS_Store
 create mode 100644 doc/.DS_Store
 create mode 100644 doc/design/proposal-strip-types.md

diff --git a/.DS_Store b/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..7521819700943c6244f084707dcaba18b3eba1b1
GIT binary patch
literal 6148
zcmeHKJ5Iwu5S?*cSkR=TLVE(FbVzBO$dpvMKonaFNU@v(Itm{n+<+T!0}jI#Xn3<T
z5U*lUB7|n7-8Va*9s5b%^$-y+ADbD`l!yupK^A31#60TCELfZ@d+fHeRo%7wkxl-p
zNuE8YE85aMJtWVcT_1+NwyUbmuG_#?yw^|jv&*+d>TiDZ@9zfO<ZGnTgc|CoPO37$
z9zDaF&mS+htTipK?T!^sy-B?+NIe&4z!`7`oB?M*7{Hw^Qk*OL><l;q&cHVVay|qM
z!P2l-j7JBi*a84^n4>_KUP5w$VQJVa!UJJV1!^i=i@}->d$73DuvgS{VrxFwDt|RE
z9IIph5W|T}MW3AkXCP%@qRXk=|2Oz#Mw|RJ#aGUNGw{zC;JjK@OT3ibttYQ1cWuB}
tV~9vxFA4;D@)LlCoFf;}ss123;!49_QFak~Ob7apKqSN`XW$nY_yqk)K!pGR

literal 0
HcmV?d00001

diff --git a/doc/.DS_Store b/doc/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..1d01845dfdad24a772252b59db2de38fc295b973
GIT binary patch
literal 6148
zcmeHKu};H447E#zidZ@_q5FmYL8!vW)PV`9Dya%m(^M+#H}MB7NDORz2_L|>@BuuZ
zt<rFXZU|Mj<a-yNeQ{n+aZE%!ysrjCeIn{X1v^I=wur2YX3{Z>EOOdoMvM7uFuHE)
zW#;XM|Hy#6yF;pIN-Mgh?EQ_OzpvL#Sx)B71oqzL%hMH~zMbVh)lQ$~&E`3Y*aC;F
zMjlhTLnaI4vTC2D$M<bMoB2F^yk1y7*<N+?mD6v2t-LtpCAqmc1I~amuulx2W{dQW
z6@7FDoB?NG&47F#0#vXtjEd>gfg!a3z%I;5Fqd9JVuE2|7!|PsVGRXpC|irc8V-9f
zzrrvoYB;eqA8dDK>rgn|9s7smPFyJZ=nOamZ3YhXvM=@j{OA6^9pqQefHSaH3~;v`
zl|wv|)z<9cq}B%L7%C!uQE?rDNh-zgl~Q~HO#*w639vAXim*WZM<CJQgER1_415Bl
CL{Aj}

literal 0
HcmV?d00001

diff --git a/doc/design/proposal-strip-types.md b/doc/design/proposal-strip-types.md
new file mode 100644
index 0000000..4d12c87
--- /dev/null
+++ b/doc/design/proposal-strip-types.md
@@ -0,0 +1,71 @@
+# Strip Types Design
+
+## Problem
+
+TypeScript support has been for a few years at the top of the list of features that users want to see in Node.js.
+Discussion has been on going for a few years [#43818](https://github.com/nodejs/node/issues/43818), and the main blocker has been the lack of a clear on long term support.
+TypeScript does not follow semver, and the Node.js project has been reluctant to commit to supporting TypeScript in the long term, given that the lifespan of an LTS version is 3 years.
+
+## Goals
+
+- Make sure Node.js can support TypeScript with the stability guarantees that has always offered.
+- Avoid breaking the ecosystem by creating a new "flavor" that only works on Node.js.
+- Performance.
+- Keeping it simple, provide the foundations for user to build on top.
+
+## Initial Proposal
+
+The proposal is to add a new flag to the Node.js CLI, `--experimental-strip-types`, which will replace inline TypeScript types with whitespace.
+No type checking is performed, and types are discarded.
+
+Example:
+
+```typescript
+interface Foo {
+    bar: string;
+}
+
+throw new Error("Whitespacing");
+
+```
+
+Becomes:
+
+```javascript
+
+
+
+
+throw new Error("Whitespacing");
+
+```
+
+> Note that the missing types are replaced with whitespace, so the line numbers are preserved, so that sourcemaps are not needed.
+
+By removing types completely, we can avoid the need to commit to supporting TypeScript in the long term, as the feature is not a full TypeScript implementation.
+As in JavaScript files, file extensions are required in `import` statements and `import()` expressions.
+TypeScript features that depend on settings within `tsconfig.json`, such as paths or converting module formats, are unsupported.
+This will solve the long term compatibility issue, but might not be as complete as a full TypeScript implementation.
+
+## Limitations
+
+### `.js` extension for `.ts` files
+
+The reason is that the compiler/bundler should be responsible to resolve the correct extension at compile time.
+At runtime, the extension must be correct, not to add overhead in production when it can be solved during development.
+This is an issue that should apply to all tools that execute TypeScript at runtime.
+
+### No type checking
+
+Type checking should be done by user land tools during development, and not at runtime.
+By performing at runtime, we would be adding large overhead.
+
+### Running TypeScript in node_modules
+
+The proposal does not support running TypeScript files in `node_modules`.
+This is to avoid encouraging package maintainers to ship TypeScript files in their packages. This has been explicitly requested by TypeScript maintainers.
+
+### Monorepos support
+
+Due to not running TypeScript in `node_modules`, monorepos are not supported.
+This is a limitation that should be solved by user land tools.