playground

I'm still not too sure on the value of unknown in the example above, because it's basically removed but it's a primitive I've never really needed to use.

Lots of interesting discussion on reddit

This is a good overview https://gist.github.com/OliverJAsh/381cd397008309c4a95d8f9bd31adcd7#js-terminology

JS -> TS -> TS (strict)

e.g. gatsbyjs/gatsby#13754

Could there be a way to say "if this import doesn't exist it's OK"

--

alternative, but more drastic - a package.json could have "typeDependencies" or "toolDependencies". Which is a bit meh.

• A duck
• A tawny owl

https://twitter.com/seldo/status/1120378318442749952

https://twitter.com/redmonk/status/1108467459420385280

https://twitter.com/typescript/status/844579685749014529

https://twitter.com/drosenwasser/status/1110237435991076865

https://twitter.com/jntrnr/status/1152276213433434112

https://twitter.com/buckymoore/status/1198766550355824640

An example: @dsherret wanted nameof from C# see: https://github.com/dsherret/ts-nameof

I'd like to do a guided PR walkthrough video for PRs like:

• Unions - microsoft/TypeScript#824
• Async Functions - microsoft/TypeScript#3078
• Control Flow Analysis - microsoft/TypeScript#8010
• String Literal Types - microsoft/TypeScript#5185
• Using JSDoc to extract types - microsoft/TypeScript#6024
• JS in TS - microsoft/TypeScript#5266
• Null types - microsoft/TypeScript#7140
• Strict Functions - microsoft/TypeScript#18654
• TSX - microsoft/TypeScript#3564
• Optional Chaining - microsoft/TypeScript#33294
• Unknown - microsoft/TypeScript#24439
• Mapped Types - microsoft/TypeScript#12114
• Rest Types - microsoft/TypeScript#13470
• Type Aliases - microsoft/TypeScript#957
• Intersection Types - microsoft/TypeScript#3622

E.g adding one strict mode flag

playground

enum AB {
  Hi
}

declare const a: AB  

function helloWorld(a: AB) {

}

// has to be this
helloWorld(AB.Hi)
// can this be resolved?
helloWorld(.Hi)

• Should support importing @types - so you can make an example working with the node types etc
• templates could be improved ( could be scoped per type of projects (React/Node/Angular/jQuery) etc ) which could come with the types above
• snippets (like keyof instanceof ) which are like the complicatedy things you do once and forget
• Needs a way to format with prettier
• URLs can be broken in certain markdown parsers

Official docs: https://www.typescriptlang.org/docs/handbook/migrating-from-javascript.html

• https://medium.com/unsplash/how-we-gradually-migrated-to-typescript-at-unsplash-7a34caa24ef1
• https://www.blazemeter.com/blog/javascript-to-typescript-migration-5-best-practices

like JSX is a unique area of TypeScript, could that be just one area of a code where TSC can know a lot more about a "type" of code.

https://twitter.com/sindresorhus/status/1118025528894611456 + thread

re: microsoft/TypeScript#30825

What is a modern GJS app like? https://2017.guadec.org/wp-content/uploads/2017/06/Philip-Chimento-GUADEC-2017-Modern-Javascript-in-GNOME.pdf

GJS Repo: https://gitlab.gnome.org/GNOME/gjs/-/blob/master/doc/Home.md

Bootstrap a project:

• https://github.com/gcampax/gtk-js-app

Types:

• https://gitlab.gnome.org/ewlsh/gi.ts
• "DT" for ^ - -https://gitlab.gnome.org/ewlsh/packages.gi.ts
• https://github.com/sammydre/ts-for-gjs

Testing:

• https://gitlab.gnome.org/ewlsh/gi.ts

Tutorial:

• https://gjs-tutorial.readthedocs.io/en/latest/introduction.html

Example code showing a window

#!/usr/bin/gjs

const Gtk = imports.gi.Gtk;
Gtk.init(null);

let win = new Gtk.Window();
win.connect("delete-event", Gtk.main_quit);
win.show_all();
Gtk.main();

Devs hang out in matrix somewhere.

Notes:

• ElementaryOS does not come with gjs installed by default

microsoft/TypeScript#41165 (comment) is a pretty good overview of how comments get pulled out

Website

Nav

Six main navigation components

• Homepage
• Handbook
• Guides
• Blog
• Playground
• Community

Then there is:

• Search (mostly focused on the handbook/guides could be built at build-time)

Optional, but maybe worth it? (if so, thinking from day one is useful)

• Translations

Homepage

Not been thought of too hard yet, but some ideas

• Own the unofficial-ts logo and make it official with a tiny tweak or two
• Note the breadth of DT typing of community
• Note the developer survey results for TS

I've done redesigns of a few big JS project homepages:

• https://jestjs.io/
• https://prettier.io/
• React Native's (wanted to work on it in private)
• Relay - facebook/relay#2696

So, I feel pretty comfortable getting reasonable fidelity mockups and presenting those
to some MS designers who can help make it fit better.

Handbook

Website may come out before new handbook, so have to build with the 2nd in mind.

Note that the URLs will change across handbooks, so ideally we keep a forwaring map of the closest approximation of pages

Guides

A general idea of the guides heirarchy

Getting Started

From Scratch

• With node
• With aspx
• For the browser
• With Azure (?!?!)
• Projects which support ts out of the box (react/angular/jest etc)

From an existing project

• Improve your tooling without adding adding dependencies

• Integration with build tools

  • Webpack
  • Babel
  • TSC

• Converting a JS project to TS (current guide)

  • Common migration patterns

Building at Scale

• How to migrate to TypeScript projects work
• TypeScript with lerna / yarn workspaces
• How to diagnose problems with TSServer
• Compiler Error index ( https://doc.rust-lang.org/error-index.html )

Definitely Typed

Migrate the content of the definitely typed website into TS and update it

• What is Definitely Typed?
• How do I add types to another library
  • Adding a library to DT
  • Adding types to a library

TypeSticter

A set of documents which guide you through turning on some of the strict flags in the tsconfig explaining with examples how they affect your code

• for noImplicitAny
• for noImplicitReturns
• for strictNullChecks
• for strictFunctionTypes

Blog

Same as current, maybe start encouraging folks write their own non-release notes post in there?

Playground

Embrace, extend and enhance typescript-play. I audited the code last night
and it's pretty solid, and really simple.

Things we like which it supports:

• Multiple TS versions
• Strict by default

Extend:

• Nightly TS version (needs coordination with monaco-typescript which kinda controls which versions are available AT<>)
• Automatic type acquisition for imports
• More examples
• Make the compiled output semi-permenent, you can ask to see the compiled output
• Show tips

Export to

• convert current code to d.ts
• issue template ( which has a link for the nightly and prod release)
• Export to a Gist

Open code in

• Code Sandbox
• AST Explorer
• ts-ast-explorer

Stretch goals:

• Add support for text snippets
• replace the 2nd panel with an inspector which shows rich information about current symbol selected
• personal favourites / history
• create an edge extension that adds a run in playground anytime you see TS code blocks in markdown on github

Community

Talks to the scope of people using TS, how you can meet others to talk to it or learn more

• Meetups around the world
• Books
• TypeScript YouTube videos (Talks from us & others)

Awesome and amazing work.

Clean file struct and friendly explanation.

In some areas, I think this repo is better than wiki for those who want to contribute. Maybe this repo would not be "official", but I definitely want to take a look at this any time I meet a new question or forget something.

https://www.youtube.com/watch?v=wSdV1M7n4gQ

Basically the first 20m are getting to why there is a binding layer in TSC

https://twitter.com/wongmjane/status/1136267980466053120