์ฝ˜ํ…์ธ  ๋Œ€ํ‘œ ์ด๋ฏธ์ง€ - ๐Ÿš€ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ํŠธ๋ Œ๋“œ ๋ถ„์„๊ณผ ์ฐจ์„ธ๋Œ€ ํƒ€์ž… ์‹œ์Šคํ…œ ๋ฐœ์ „ ๋ฐฉํ–ฅ

๐Ÿš€ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ํŠธ๋ Œ๋“œ ๋ถ„์„๊ณผ ์ฐจ์„ธ๋Œ€ ํƒ€์ž… ์‹œ์Šคํ…œ ๋ฐœ์ „ ๋ฐฉํ–ฅ

ํ˜„์žฌ์™€ ๋ฏธ๋ž˜๋ฅผ ๊ด€ํ†ตํ•˜๋Š” ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ๋ชจ๋“  ๊ฒƒ

๐ŸŽฏ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ, ์™œ ์ง€๊ธˆ ์ด๋ ‡๊ฒŒ ํ•ซํ•œ๊ฐ€?

์•ˆ๋…•! ์˜ค๋Š˜์€ ๊ฐœ๋ฐœ์ž๋“ค ์‚ฌ์ด์—์„œ ์š”์ฆ˜ ๊ฐ€์žฅ ๋œจ๊ฑฐ์šด ์–ธ์–ด ์ค‘ ํ•˜๋‚˜์ธ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์— ๋Œ€ํ•ด ๊นŠ์ด ์žˆ๊ฒŒ ํŒŒํ—ค์ณ๋ณผ ๊ฑฐ์•ผ. ์†”์งํžˆ ๋งํ•˜๋ฉด, 5๋…„ ์ „๋งŒ ํ•ด๋„ "ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ? ๊ทธ๊ฑฐ ์™œ ์จ?" ๋ผ๋Š” ๋ฐ˜์‘์ด ๋งŽ์•˜๋Š”๋ฐ, ์ง€๊ธˆ์€ ์™„์ „ํžˆ ๋ถ„์œ„๊ธฐ๊ฐ€ ๋ฐ”๋€Œ์—ˆ์–ด. ๐Ÿ”ฅ

2024๋…„ ๊ธฐ์ค€์œผ๋กœ Stack Overflow ๊ฐœ๋ฐœ์ž ์„ค๋ฌธ์กฐ์‚ฌ์— ๋”ฐ๋ฅด๋ฉด, ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋Š” ๊ฐ€์žฅ ์‚ฌ๋ž‘๋ฐ›๋Š” ํ”„๋กœ๊ทธ๋ž˜๋ฐ ์–ธ์–ด 5์œ„ ์•ˆ์— ๋“ค์–ด๊ฐ”๊ณ , GitHub์—์„œ๋Š” ๊ฐ€์žฅ ๋น ๋ฅด๊ฒŒ ์„ฑ์žฅํ•˜๋Š” ์–ธ์–ด ์ค‘ ํ•˜๋‚˜๋กœ ๊ผฝํžˆ๊ณ  ์žˆ์–ด. ํŠนํžˆ ํ”„๋ก ํŠธ์—”๋“œ ๊ฐœ๋ฐœ ๋ถ„์•ผ์—์„œ๋Š” ๊ฑฐ์˜ ํ‘œ์ค€์ฒ˜๋Ÿผ ์ž๋ฆฌ ์žก์•˜์ง€.

๊ทธ๋Ÿฐ๋ฐ ์™œ ์ด๋ ‡๊ฒŒ ์ธ๊ธฐ๊ฐ€ ๋งŽ์•„์กŒ์„๊นŒ? ๊ฐ„๋‹จํ•ด. ํƒ€์ž… ์•ˆ์ •์„ฑ์ด๋ผ๋Š” ๊ฐ•๋ ฅํ•œ ๋ฌด๊ธฐ ๋•๋ถ„์ด์•ผ. ์ž๋ฐ”์Šคํฌ๋ฆฝํŠธ์˜ ์ž์œ ๋กœ์›€์€ ์œ ์ง€ํ•˜๋ฉด์„œ๋„, ๋Œ€๊ทœ๋ชจ ํ”„๋กœ์ ํŠธ์—์„œ ๋ฐœ์ƒํ•  ์ˆ˜ ์žˆ๋Š” ๋ฒ„๊ทธ๋ฅผ ์‚ฌ์ „์— ์žก์•„๋‚ผ ์ˆ˜ ์žˆ๊ฑฐ๋“ . ๋งˆ์น˜ ์•ˆ์ „๋ฒจํŠธ๋ฅผ ๋งค๊ณ  ์šด์ „ํ•˜๋Š” ๊ฒƒ๊ณผ ๊ฐ™์€ ๋А๋‚Œ์ด๋ž„๊นŒ? ๐Ÿ›ก๏ธ
TypeScript ์„ฑ์žฅ ์ถ”์ด 2018 2019 2020 2024 ํƒ€์ž… ์•ˆ์ •์„ฑ Type Safety ๊ฐœ๋ฐœ ์ƒ์‚ฐ์„ฑ Productivity ์ฝ”๋“œ ํ’ˆ์งˆ Code Quality ํŒ€ ํ˜‘์—… Collaboration

๐Ÿ“Š 2024๋…„ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ํŠธ๋ Œ๋“œ ํ˜„ํ™ฉ

์ž, ์ด์ œ ๋ณธ๊ฒฉ์ ์œผ๋กœ ํ˜„์žฌ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์ƒํƒœ๊ณ„๊ฐ€ ์–ด๋–ป๊ฒŒ ๋Œ์•„๊ฐ€๊ณ  ์žˆ๋Š”์ง€ ์‚ดํŽด๋ณผ๊นŒ? ์ตœ๊ทผ ๋ช‡ ๋…„๊ฐ„ ์ •๋ง ๋งŽ์€ ๋ณ€ํ™”๊ฐ€ ์žˆ์—ˆ์–ด. ๐Ÿ“ˆ

๐ŸŒŸ ์ฃผ์š” ์ฑ„ํƒ ํ˜„ํ™ฉ

๋จผ์ € ๋†€๋ผ์šด ํ†ต๊ณ„๋ถ€ํ„ฐ ๋ณด์ž. 2024๋…„ ํ˜„์žฌ npm ๋‹ค์šด๋กœ๋“œ ๊ธฐ์ค€์œผ๋กœ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋Š” ์ฃผ๊ฐ„ 5์ฒœ๋งŒ ํšŒ ์ด์ƒ ๋‹ค์šด๋กœ๋“œ๋˜๊ณ  ์žˆ์–ด. ์ด๊ฒŒ ์–ผ๋งˆ๋‚˜ ๋Œ€๋‹จํ•œ ์ˆ˜์น˜๋ƒ๋ฉด, 5๋…„ ์ „๊ณผ ๋น„๊ตํ–ˆ์„ ๋•Œ ์•ฝ 10๋ฐฐ ์ด์ƒ ์ฆ๊ฐ€ํ•œ ๊ฑฐ์•ผ. ๐Ÿš€

ํŠนํžˆ ์ฃผ๋ชฉํ•  ๋งŒํ•œ ๊ฑด ๊ธฐ์—…๋“ค์˜ ์ฑ„ํƒ๋ฅ ์ด์•ผ. ๊ตฌ๊ธ€, ๋งˆ์ดํฌ๋กœ์†Œํ”„ํŠธ, ์—์–ด๋น„์•ค๋น„, ์Šฌ๋ž™, ์•„์‚ฌ๋‚˜ ๋“ฑ ๊ธ€๋กœ๋ฒŒ ํ…Œํฌ ๊ธฐ์—…๋“ค์€ ๋ฌผ๋ก ์ด๊ณ , ๊ตญ๋‚ด ๋Œ€๊ธฐ์—…๋“ค๋„ ์•ž๋‹คํˆฌ์–ด ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋กœ ์ „ํ™˜ํ•˜๊ณ  ์žˆ์–ด. ๋„ค์ด๋ฒ„, ์นด์นด์˜ค, ํ† ์Šค ๊ฐ™์€ ํšŒ์‚ฌ๋“ค๋„ ์‹ ๊ทœ ํ”„๋กœ์ ํŠธ๋Š” ๊ฑฐ์˜ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋กœ ์‹œ์ž‘ํ•œ๋‹ค๊ณ  ๋ด๋„ ๋ฌด๋ฐฉํ•ด.

๐Ÿ’ผ ๊ธฐ์—…๋ณ„ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ํ™œ์šฉ ์‚ฌ๋ก€

๐Ÿ”ต Microsoft (๋งˆ์ดํฌ๋กœ์†Œํ”„ํŠธ)
๋‹น์—ฐํ•˜๊ฒŒ๋„ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋ฅผ ๋งŒ๋“  ํšŒ์‚ฌ๋‹ต๊ฒŒ, VS Code๋ฅผ ๋น„๋กฏํ•œ ๊ฑฐ์˜ ๋ชจ๋“  ํ”„๋กœ์ ํŠธ์—์„œ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋ฅผ ์‚ฌ์šฉํ•˜๊ณ  ์žˆ์–ด. VS Code ์ž์ฒด๊ฐ€ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋กœ ์ž‘์„ฑ๋˜์—ˆ๊ณ , ์ด๋Š” ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ๊ฐ•๋ ฅํ•จ์„ ์ฆ๋ช…ํ•˜๋Š” ์ตœ๊ณ ์˜ ์‚ฌ๋ก€์ง€.

๐Ÿ”ด Google (๊ตฌ๊ธ€)
๊ตฌ๊ธ€์€ ์›๋ž˜ ์ž์ฒด ํƒ€์ž… ์‹œ์Šคํ…œ์ธ Closure Compiler๋ฅผ ์‚ฌ์šฉํ–ˆ์ง€๋งŒ, ์ตœ๊ทผ์—๋Š” Angular ํ”„๋ ˆ์ž„์›Œํฌ๋ฅผ ํ•„๋‘๋กœ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋กœ ๋Œ€๊ฑฐ ์ „ํ™˜ํ–ˆ์–ด. Angular 2+ ๋ฒ„์ „๋ถ€ํ„ฐ๋Š” ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๊ฐ€ ๊ธฐ๋ณธ ์–ธ์–ด๊ฐ€ ๋˜์—ˆ์ง€.

๐ŸŸข Airbnb (์—์–ด๋น„์•ค๋น„)
์—์–ด๋น„์•ค๋น„๋Š” 2019๋…„์— ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ๋„์ž… ํ›„ 38%์˜ ๋ฒ„๊ทธ๋ฅผ ์‚ฌ์ „์— ๋ฐฉ์ง€ํ•  ์ˆ˜ ์žˆ์—ˆ๋‹ค๊ณ  ๊ณต์‹ ๋ฐœํ‘œํ–ˆ์–ด. ์ด๊ฑด ์ •๋ง ์—„์ฒญ๋‚œ ์ˆ˜์น˜์•ผ. ๋ฒ„๊ทธ ํ•˜๋‚˜ ๊ณ ์น˜๋Š” ๋ฐ ๋“œ๋Š” ์‹œ๊ฐ„๊ณผ ๋น„์šฉ์„ ์ƒ๊ฐํ•˜๋ฉด ๋ง์ด์ง€.

๐ŸŸก Slack (์Šฌ๋ž™)
์Šฌ๋ž™์€ ๋Œ€๊ทœ๋ชจ ์ฝ”๋“œ๋ฒ ์ด์Šค๋ฅผ ์ž๋ฐ”์Šคํฌ๋ฆฝํŠธ์—์„œ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋กœ ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ํ•˜๋ฉด์„œ, ๊ฐœ๋ฐœ์ž ์ƒ์‚ฐ์„ฑ์ด ํฌ๊ฒŒ ํ–ฅ์ƒ๋˜์—ˆ๋‹ค๊ณ  ๋ณด๊ณ ํ–ˆ์–ด. ํŠนํžˆ ๋ฆฌํŒฉํ† ๋ง ์ž‘์—…์ด ํ›จ์”ฌ ์•ˆ์ „ํ•˜๊ณ  ๋นจ๋ผ์กŒ๋‹ค๊ณ  ํ•ด.

๐ŸŽจ ํ”„๋ ˆ์ž„์›Œํฌ ์ƒํƒœ๊ณ„์˜ ๋ณ€ํ™”

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ์˜ํ–ฅ๋ ฅ์€ ํ”„๋ ˆ์ž„์›Œํฌ ์ƒํƒœ๊ณ„์—์„œ๋„ ํ™•์—ฐํžˆ ๋“œ๋Ÿฌ๋‚˜. ์š”์ฆ˜ ๋‚˜์˜ค๋Š” ๊ฑฐ์˜ ๋ชจ๋“  ๋ชจ๋˜ ํ”„๋ ˆ์ž„์›Œํฌ๋“ค์ด ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋ฅผ 1๊ธ‰ ์‹œ๋ฏผ(First-class citizen)์œผ๋กœ ์ง€์›ํ•˜๊ณ  ์žˆ์–ด. ๐ŸŽฏ

React
๋ฆฌ์•กํŠธ๋Š” ์ž๋ฐ”์Šคํฌ๋ฆฝํŠธ๋กœ ์ž‘์„ฑ๋˜์—ˆ์ง€๋งŒ, ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์ง€์›์ด ์ •๋ง ํ›Œ๋ฅญํ•ด. Create React App์—์„œ๋„ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ํ…œํ”Œ๋ฆฟ์„ ๊ณต์‹ ์ง€์›ํ•˜๊ณ , ์ตœ๊ทผ์—๋Š” ๋งŽ์€ ๊ฐœ๋ฐœ์ž๋“ค์ด ์ฒ˜์Œ๋ถ€ํ„ฐ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋กœ ๋ฆฌ์•กํŠธ ํ”„๋กœ์ ํŠธ๋ฅผ ์‹œ์ž‘ํ•ด. @types/react ํŒจํ‚ค์ง€์˜ ๋‹ค์šด๋กœ๋“œ ์ˆ˜๋งŒ ๋ด๋„ ์•Œ ์ˆ˜ ์žˆ์ง€.

Vue.js
Vue 3๋ถ€ํ„ฐ๋Š” ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋กœ ์žฌ์ž‘์„ฑ๋˜์—ˆ์–ด. Vue 2 ์‹œ์ ˆ์—๋Š” ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์ง€์›์ด ์ข€ ์•„์‰ฌ์› ๋Š”๋ฐ, Vue 3์—์„œ๋Š” ์™„์ „ํžˆ ๋‹ฌ๋ผ์กŒ์ง€. Composition API์™€ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ์กฐํ•ฉ์€ ์ •๋ง ํ™˜์ƒ์ ์ด์•ผ.

Angular
Angular๋Š” ์ฒ˜์Œ๋ถ€ํ„ฐ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋ฅผ ๊ธฐ๋ณธ ์–ธ์–ด๋กœ ์ฑ„ํƒํ–ˆ์–ด. ์‚ฌ์‹ค์ƒ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์—†์ด๋Š” Angular๋ฅผ ์ œ๋Œ€๋กœ ์‚ฌ์šฉํ•  ์ˆ˜ ์—†๋‹ค๊ณ  ๋ด๋„ ๋ผ. ์ด๊ฒŒ Angular์˜ ๊ฐ•์ ์ด์ž ์ง„์ž… ์žฅ๋ฒฝ์ด๊ธฐ๋„ ํ•˜์ง€.

Svelte
์Šค๋ฒจํŠธ๋„ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์ง€์›์ด ์ •๋ง ์ข‹์•„์กŒ์–ด. SvelteKit์—์„œ๋Š” ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋ฅผ ๊ธฐ๋ณธ์œผ๋กœ ์„ค์ •ํ•  ์ˆ˜ ์žˆ๊ณ , ํƒ€์ž… ์ฒดํ‚น๋„ ๋งค๋„๋Ÿฝ๊ฒŒ ์ž‘๋™ํ•ด.

Next.js & Remix
์„œ๋ฒ„ ์‚ฌ์ด๋“œ ๋ Œ๋”๋ง ํ”„๋ ˆ์ž„์›Œํฌ๋“ค๋„ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋ฅผ ์ ๊ทน ์ง€์›ํ•ด. Next.js๋Š” ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์„ค์ •์ด ์ •๋ง ๊ฐ„๋‹จํ•˜๊ณ , Remix๋„ ํƒ€์ž… ์•ˆ์ •์„ฑ์„ ์ค‘์š”ํ•˜๊ฒŒ ์ƒ๊ฐํ•˜๋Š” ํ”„๋ ˆ์ž„์›Œํฌ์•ผ.
๐Ÿ’ก ์žฌ๋Šฅ๋„ท์—์„œ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ๋ฐฐ์šฐ๊ธฐ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋ฅผ ์ฒ˜์Œ ์‹œ์ž‘ํ•˜๊ฑฐ๋‚˜ ๋” ๊นŠ์ด ์žˆ๊ฒŒ ๋ฐฐ์šฐ๊ณ  ์‹ถ๋‹ค๋ฉด, ์žฌ๋Šฅ๋„ท์—์„œ ๋‹ค์–‘ํ•œ ์ „๋ฌธ๊ฐ€๋“ค์˜ ๊ฐ•์˜์™€ ๋ฉ˜ํ† ๋ง์„ ๋ฐ›์•„๋ณผ ์ˆ˜ ์žˆ์–ด. ์‹ค๋ฌด ๊ฒฝํ—˜์ด ํ’๋ถ€ํ•œ ๊ฐœ๋ฐœ์ž๋“ค์ด ์ง์ ‘ ์ฝ”๋“œ ๋ฆฌ๋ทฐ๋„ ํ•ด์ฃผ๊ณ , ํ”„๋กœ์ ํŠธ ๊ตฌ์กฐ ์„ค๊ณ„๋ถ€ํ„ฐ ๊ณ ๊ธ‰ ํƒ€์ž… ์‹œ์Šคํ…œ ํ™œ์šฉ๊นŒ์ง€ ์ฒด๊ณ„์ ์œผ๋กœ ๋ฐฐ์šธ ์ˆ˜ ์žˆ์ง€. ํŠนํžˆ ์‹ค์ „ ํ”„๋กœ์ ํŠธ ๊ธฐ๋ฐ˜์œผ๋กœ ๋ฐฐ์šฐ๋ฉด ํ›จ์”ฌ ํšจ๊ณผ์ ์ด์•ผ! ๐ŸŽ“

๐Ÿ”ฌ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ํƒ€์ž… ์‹œ์Šคํ…œ ์‹ฌ์ธต ๋ถ„์„

์ด์ œ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ํ•ต์‹ฌ์ธ ํƒ€์ž… ์‹œ์Šคํ…œ์— ๋Œ€ํ•ด ๊นŠ์ด ํŒŒ๊ณ ๋“ค์–ด๋ณผ๊นŒ? ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ํƒ€์ž… ์‹œ์Šคํ…œ์€ ์ •๋ง ๊ฐ•๋ ฅํ•˜๊ณ  ํ‘œํ˜„๋ ฅ์ด ๋›ฐ์–ด๋‚˜. ๋‹จ์ˆœํžˆ "์ด ๋ณ€์ˆ˜๋Š” ์ˆซ์ž์•ผ, ์ € ๋ณ€์ˆ˜๋Š” ๋ฌธ์ž์—ด์ด์•ผ" ์ˆ˜์ค€์„ ํ›จ์”ฌ ๋„˜์–ด์„œ๊ฑฐ๋“ . ๐Ÿงฌ

๐ŸŽญ ๊ตฌ์กฐ์  ํƒ€์ดํ•‘ (Structural Typing)

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ๊ฐ€์žฅ ์ค‘์š”ํ•œ ํŠน์ง• ์ค‘ ํ•˜๋‚˜๊ฐ€ ๋ฐ”๋กœ ๊ตฌ์กฐ์  ํƒ€์ดํ•‘์ด์•ผ. ์ด๊ฒŒ ๋ญ๋ƒ๋ฉด, ํƒ€์ž…์˜ ์ด๋ฆ„์ด ์•„๋‹ˆ๋ผ ๊ตฌ์กฐ(shape)๋กœ ํƒ€์ž…์„ ํŒ๋‹จํ•œ๋‹ค๋Š” ๊ฑฐ์ง€.

์˜ˆ๋ฅผ ๋“ค์–ด๋ณผ๊ฒŒ:
interface Point {
  x: number;
  y: number;
}

interface Vector {
  x: number;
  y: number;
}

function printPoint(p: Point) {
  console.log(`x: ${p.x}, y: ${p.y}`);
}

const vector: Vector = { x: 10, y: 20 };
printPoint(vector); // ๋ฌธ์ œ์—†์ด ์ž‘๋™!
๋ณด๋‹ค์‹œํ”ผ Point์™€ Vector๋Š” ์™„์ „ํžˆ ๋‹ค๋ฅธ ํƒ€์ž…์ด์ง€๋งŒ, ๊ตฌ์กฐ๊ฐ€ ๊ฐ™๊ธฐ ๋•Œ๋ฌธ์— ์„œ๋กœ ํ˜ธํ™˜๋ผ. ์ด๊ฒŒ ๋ฐ”๋กœ ๊ตฌ์กฐ์  ํƒ€์ดํ•‘์˜ ๋งˆ๋ฒ•์ด์•ผ. ์ž๋ฐ”๋‚˜ C# ๊ฐ™์€ ๋ช…๋ชฉ์  ํƒ€์ดํ•‘(Nominal Typing) ์–ธ์–ด์—์„œ๋Š” ์ด๊ฒŒ ๋ถˆ๊ฐ€๋Šฅํ•˜์ง€.

์ด๋Ÿฐ ํŠน์„ฑ ๋•๋ถ„์— ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋Š” ์ž๋ฐ”์Šคํฌ๋ฆฝํŠธ์˜ ์œ ์—ฐ์„ฑ์„ ํ•ด์น˜์ง€ ์•Š์œผ๋ฉด์„œ๋„ ํƒ€์ž… ์•ˆ์ •์„ฑ์„ ์ œ๊ณตํ•  ์ˆ˜ ์žˆ์–ด. ๋• ํƒ€์ดํ•‘(Duck Typing)์˜ ์ฒ ํ•™๊ณผ๋„ ์ž˜ ๋งž์•„๋–จ์–ด์ง€์ง€. "์˜ค๋ฆฌ์ฒ˜๋Ÿผ ๊ฑท๊ณ  ์˜ค๋ฆฌ์ฒ˜๋Ÿผ ๊ฝฅ๊ฝฅ๊ฑฐ๋ฆฌ๋ฉด, ๊ทธ๊ฑด ์˜ค๋ฆฌ๋‹ค!" ๐Ÿฆ†

๐Ÿ”ฎ ๊ณ ๊ธ‰ ํƒ€์ž… ๊ธฐ๋Šฅ๋“ค

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ํƒ€์ž… ์‹œ์Šคํ…œ์€ ์ •๋ง ๊ฐ•๋ ฅํ•œ ๊ธฐ๋Šฅ๋“ค์„ ์ œ๊ณตํ•ด. ํ•˜๋‚˜์”ฉ ์‚ดํŽด๋ณด์ž.

1. Union Types (์œ ๋‹ˆ์˜จ ํƒ€์ž…)
์—ฌ๋Ÿฌ ํƒ€์ž… ์ค‘ ํ•˜๋‚˜๊ฐ€ ๋  ์ˆ˜ ์žˆ๋Š” ๊ฐ’์„ ํ‘œํ˜„ํ•  ๋•Œ ์‚ฌ์šฉํ•ด:
type Status = "pending" | "success" | "error";

function handleStatus(status: Status) {
  switch (status) {
    case "pending":
      console.log("์ฒ˜๋ฆฌ ์ค‘...");
      break;
    case "success":
      console.log("์„ฑ๊ณต!");
      break;
    case "error":
      console.log("์—๋Ÿฌ ๋ฐœ์ƒ");
      break;
  }
}
์ด๋ ‡๊ฒŒ ํ•˜๋ฉด ์˜คํƒ€๋กœ ์ธํ•œ ๋ฒ„๊ทธ๋ฅผ ์™„์ „ํžˆ ๋ฐฉ์ง€ํ•  ์ˆ˜ ์žˆ์–ด. "succes" ๊ฐ™์€ ์˜คํƒ€๋ฅผ ์น˜๋ฉด ์ปดํŒŒ์ผ ํƒ€์ž„์— ๋ฐ”๋กœ ์žก์•„์ฃผ๊ฑฐ๋“ . โœจ

2. Intersection Types (๊ต์ฐจ ํƒ€์ž…)
์—ฌ๋Ÿฌ ํƒ€์ž…์„ ํ•ฉ์ณ์„œ ์ƒˆ๋กœ์šด ํƒ€์ž…์„ ๋งŒ๋“ค ์ˆ˜ ์žˆ์–ด:
interface Colorful {
  color: string;
}

interface Circle {
  radius: number;
}

type ColorfulCircle = Colorful & Circle;

const cc: ColorfulCircle = {
  color: "red",
  radius: 42
};
3. Conditional Types (์กฐ๊ฑด๋ถ€ ํƒ€์ž…)
์ด๊ฑด ์ •๋ง ๊ฐ•๋ ฅํ•œ ๊ธฐ๋Šฅ์ด์•ผ. ํƒ€์ž… ๋ ˆ๋ฒจ์—์„œ ์กฐ๊ฑด๋ฌธ์„ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์–ด:
type IsString<T> = T extends string ? true : false;

type A = IsString<string>;  // true
type B = IsString<number>;  // false

// ์‹ค์šฉ์ ์ธ ์˜ˆ์ œ
type Flatten<T> = T extends Array<infer U> ? U : T;

type Str = Flatten<string[]>;  // string
type Num = Flatten<number>;    // number
์ด๋Ÿฐ ๊ณ ๊ธ‰ ํƒ€์ž… ๊ธฐ๋Šฅ๋“ค์„ ํ™œ์šฉํ•˜๋ฉด ์ •๋ง ๋ณต์žกํ•œ ํƒ€์ž… ๊ด€๊ณ„๋„ ํ‘œํ˜„ํ•  ์ˆ˜ ์žˆ์–ด. ๋งˆ์น˜ ํƒ€์ž… ๋ ˆ๋ฒจ์—์„œ ํ”„๋กœ๊ทธ๋ž˜๋ฐ์„ ํ•˜๋Š” ๊ฒƒ ๊ฐ™์€ ๋А๋‚Œ์ด์ง€. ๐ŸŽจ

4. Mapped Types (๋งคํ•‘๋œ ํƒ€์ž…)
๊ธฐ์กด ํƒ€์ž…์„ ๋ณ€ํ™˜ํ•ด์„œ ์ƒˆ๋กœ์šด ํƒ€์ž…์„ ๋งŒ๋“ค ์ˆ˜ ์žˆ์–ด:
type Readonly<T> = {
  readonly [P in keyof T]: T[P];
};

type Partial<T> = {
  [P in keyof T]?: T[P];
};

interface User {
  name: string;
  age: number;
}

type ReadonlyUser = Readonly<User>;
// { readonly name: string; readonly age: number; }

type PartialUser = Partial<User>;
// { name?: string; age?: number; }
์‹ค์ œ๋กœ Readonly์™€ Partial์€ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์— ๋‚ด์žฅ๋œ ์œ ํ‹ธ๋ฆฌํ‹ฐ ํƒ€์ž…์ด์•ผ. ์ด๋Ÿฐ ์‹์œผ๋กœ ํƒ€์ž…์„ ๋ณ€ํ™˜ํ•˜๋Š” ํŒจํ„ด์€ ์ •๋ง ์œ ์šฉํ•˜๊ฒŒ ์“ฐ์—ฌ.

5. Template Literal Types (ํ…œํ”Œ๋ฆฟ ๋ฆฌํ„ฐ๋Ÿด ํƒ€์ž…)
ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ 4.1์—์„œ ์ถ”๊ฐ€๋œ ๊ธฐ๋Šฅ์ธ๋ฐ, ๋ฌธ์ž์—ด ๋ฆฌํ„ฐ๋Ÿด ํƒ€์ž…์„ ์กฐํ•ฉํ•  ์ˆ˜ ์žˆ์–ด:
type Direction = "left" | "right" | "top" | "bottom";
type Alignment = "start" | "center" | "end";

type AlignedDirection = `${Direction}-${Alignment}`;
// "left-start" | "left-center" | "left-end" | 
// "right-start" | "right-center" | ... (์ด 12๊ฐœ)
์ด ๊ธฐ๋Šฅ์€ CSS ํด๋ž˜์Šค๋ช…์ด๋‚˜ ์ด๋ฒคํŠธ ์ด๋ฆ„ ๊ฐ™์€ ๊ฑธ ํƒ€์ž… ์•ˆ์ „ํ•˜๊ฒŒ ๋‹ค๋ฃฐ ๋•Œ ์ •๋ง ์œ ์šฉํ•ด. ๐ŸŽฏ

๐Ÿงช ํƒ€์ž… ์ถ”๋ก ์˜ ๋งˆ๋ฒ•

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ๋˜ ๋‹ค๋ฅธ ๊ฐ•์ ์€ ํƒ€์ž… ์ถ”๋ก (Type Inference)์ด์•ผ. ๋ชจ๋“  ํƒ€์ž…์„ ์ผ์ผ์ด ๋ช…์‹œํ•˜์ง€ ์•Š์•„๋„ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๊ฐ€ ์•Œ์•„์„œ ํƒ€์ž…์„ ์ถ”๋ก ํ•ด์ค˜.

๊ธฐ๋ณธ ํƒ€์ž… ์ถ”๋ก 
๋ณ€์ˆ˜๋ฅผ ์„ ์–ธํ•  ๋•Œ ํƒ€์ž…์„ ๋ช…์‹œํ•˜์ง€ ์•Š์•„๋„ ์ดˆ๊ธฐ๊ฐ’์œผ๋กœ๋ถ€ํ„ฐ ํƒ€์ž…์„ ์ถ”๋ก ํ•ด:
let x = 3;  // number๋กœ ์ถ”๋ก 
let y = "hello";  // string์œผ๋กœ ์ถ”๋ก 
let z = [1, 2, 3];  // number[]๋กœ ์ถ”๋ก 

// ํ•จ์ˆ˜ ๋ฐ˜ํ™˜ ํƒ€์ž…๋„ ์ถ”๋ก 
function add(a: number, b: number) {
  return a + b;  // ๋ฐ˜ํ™˜ ํƒ€์ž…์ด number๋กœ ์ถ”๋ก ๋จ
}
๋ฌธ๋งฅ์  ํƒ€์ดํ•‘ (Contextual Typing)
ํ•จ์ˆ˜์˜ ๋งค๊ฐœ๋ณ€์ˆ˜ ํƒ€์ž…๋„ ๋ฌธ๋งฅ์— ๋”ฐ๋ผ ์ถ”๋ก ๋ผ:
const numbers = [1, 2, 3, 4, 5];

// num์˜ ํƒ€์ž…์ด ์ž๋™์œผ๋กœ number๋กœ ์ถ”๋ก ๋จ
numbers.forEach(num => {
  console.log(num.toFixed(2));
});
์ด๋Ÿฐ ํƒ€์ž… ์ถ”๋ก  ๋•๋ถ„์— ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์ฝ”๋“œ๊ฐ€ ์ž๋ฐ”์Šคํฌ๋ฆฝํŠธ์ฒ˜๋Ÿผ ๊ฐ„๊ฒฐํ•˜๋ฉด์„œ๋„ ํƒ€์ž… ์•ˆ์ •์„ฑ์„ ์œ ์ง€ํ•  ์ˆ˜ ์žˆ์–ด. ์ •๋ง ๋˜‘๋˜‘ํ•˜์ง€? ๐Ÿง 

๐Ÿš€ ์ตœ์‹  ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ๋ฒ„์ „๋ณ„ ์ฃผ์š” ๊ธฐ๋Šฅ

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋Š” ๊ณ„์†ํ•ด์„œ ๋ฐœ์ „ํ•˜๊ณ  ์žˆ์–ด. ์ตœ๊ทผ ๋ช‡ ๋…„๊ฐ„ ์ถ”๊ฐ€๋œ ์ฃผ์š” ๊ธฐ๋Šฅ๋“ค์„ ์‚ดํŽด๋ณด์ž. ๐Ÿ“š

TypeScript 5.0 (2023๋…„ 3์›”)

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ 5.0์€ ์ •๋ง ํฐ ๋ณ€ํ™”๊ฐ€ ์žˆ์—ˆ์–ด. ๋ฉ”์ด์ € ๋ฒ„์ „ ์—…๋ฐ์ดํŠธ๋‹ต๊ฒŒ ๋ง์ด์ง€.

1. Decorators (๋ฐ์ฝ”๋ ˆ์ดํ„ฐ) ์ •์‹ ์ง€์›
๋“œ๋””์–ด ECMAScript ํ‘œ์ค€์— ๋งž์ถฐ์ง„ ๋ฐ์ฝ”๋ ˆ์ดํ„ฐ๊ฐ€ ์ •์‹์œผ๋กœ ์ง€์›๋์–ด. ์ด์ „๊นŒ์ง€๋Š” ์‹คํ—˜์  ๊ธฐ๋Šฅ์ด์—ˆ๋Š”๋ฐ, ์ด์ œ๋Š” ์•ˆ์ •์ ์œผ๋กœ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์ง€:
function logged(target: any, propertyKey: string, descriptor: PropertyDescriptor) {
  const original = descriptor.value;
  
  descriptor.value = function(...args: any[]) {
    console.log(`Calling ${propertyKey} with`, args);
    return original.apply(this, args);
  };
  
  return descriptor;
}

class Calculator {
  @logged
  add(a: number, b: number) {
    return a + b;
  }
}
2. const Type Parameters
์ œ๋„ค๋ฆญ ํƒ€์ž… ๋งค๊ฐœ๋ณ€์ˆ˜๋ฅผ const๋กœ ์„ ์–ธํ•  ์ˆ˜ ์žˆ๊ฒŒ ๋์–ด. ์ด๊ฒŒ ๋ญ๊ฐ€ ์ข‹๋ƒ๋ฉด, ํƒ€์ž… ์ถ”๋ก ์ด ๋” ์ •ํ™•ํ•ด์ ธ:
function identity<const T>(value: T): T {
  return value;
}

const result = identity({ name: "Alice", age: 30 });
// ํƒ€์ž…์ด { name: string; age: number; }๊ฐ€ ์•„๋‹ˆ๋ผ
// { readonly name: "Alice"; readonly age: 30; }๋กœ ์ถ”๋ก ๋จ
3. ์„ฑ๋Šฅ ๊ฐœ์„ 
ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ 5.0์—์„œ๋Š” ๋‚ด๋ถ€ ๊ตฌ์กฐ๋ฅผ ๋Œ€ํญ ๊ฐœ์„ ํ•ด์„œ ์ปดํŒŒ์ผ ์†๋„๊ฐ€ ํฌ๊ฒŒ ๋นจ๋ผ์กŒ์–ด. ํŠนํžˆ ๋Œ€๊ทœ๋ชจ ํ”„๋กœ์ ํŠธ์—์„œ ์ฒด๊ฐํ•  ์ˆ˜ ์žˆ๋Š” ์ˆ˜์ค€์ด์•ผ. โšก

TypeScript 5.1 (2023๋…„ 6์›”)

1. Easier Implicit Returns for undefined-returning Functions
undefined๋ฅผ ๋ฐ˜ํ™˜ํ•˜๋Š” ํ•จ์ˆ˜์—์„œ ๋ช…์‹œ์ ์œผ๋กœ return์„ ์“ฐ์ง€ ์•Š์•„๋„ ๋˜๊ฒŒ ๊ฐœ์„ ๋์–ด:
function logMessage(message: string): undefined {
  console.log(message);
  // return undefined; ๋ฅผ ์“ฐ์ง€ ์•Š์•„๋„ OK!
}
2. Unrelated Types for Getters and Setters
getter์™€ setter์˜ ํƒ€์ž…์ด ๋‹ฌ๋ผ๋„ ๋˜๊ฒŒ ๋์–ด. ์ด๊ฒŒ ์‹ค๋ฌด์—์„œ ๊ฝค ์œ ์šฉํ•ด:
class Thing {
  #size = 0;

  get size(): number {
    return this.#size;
  }

  set size(value: number | string | boolean) {
    let num = Number(value);
    if (!Number.isFinite(num)) {
      this.#size = 0;
      return;
    }
    this.#size = num;
  }
}

TypeScript 5.2 (2023๋…„ 8์›”)

1. using Declarations
๋ฆฌ์†Œ์Šค ๊ด€๋ฆฌ๋ฅผ ์œ„ํ•œ using ์„ ์–ธ์ด ์ถ”๊ฐ€๋์–ด. ์ด๊ฑด ECMAScript์˜ Explicit Resource Management ์ œ์•ˆ์„ ๋”ฐ๋ฅธ ๊ฑฐ์•ผ:
function doWork() {
  using file = openFile("data.txt");
  // file์„ ์‚ฌ์šฉํ•˜๋Š” ์ž‘์—…๋“ค...
  // ํ•จ์ˆ˜๊ฐ€ ๋๋‚˜๋ฉด ์ž๋™์œผ๋กœ file์ด ์ •๋ฆฌ๋จ
}
2. Decorator Metadata
๋ฐ์ฝ”๋ ˆ์ดํ„ฐ์—์„œ ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ๋ฅผ ๋” ์‰ฝ๊ฒŒ ๋‹ค๋ฃฐ ์ˆ˜ ์žˆ๊ฒŒ ๋์–ด. ์ด๊ฑด ํŠนํžˆ ์˜์กด์„ฑ ์ฃผ์ž… ๊ฐ™์€ ํŒจํ„ด์—์„œ ์œ ์šฉํ•ด.

TypeScript 5.3 (2023๋…„ 11์›”)

1. Import Attributes
JSON ๊ฐ™์€ ๋น„-JavaScript ๋ชจ๋“ˆ์„ importํ•  ๋•Œ ์†์„ฑ์„ ์ง€์ •ํ•  ์ˆ˜ ์žˆ๊ฒŒ ๋์–ด:
import data from "./data.json" with { type: "json" };
2. Switch (true) Narrowing
switch (true) ํŒจํ„ด์—์„œ ํƒ€์ž… ์ขํžˆ๊ธฐ๊ฐ€ ๋” ์ž˜ ์ž‘๋™ํ•˜๊ฒŒ ๊ฐœ์„ ๋์–ด.

TypeScript 5.4 (2024๋…„ 3์›”)

1. NoInfer Utility Type
ํƒ€์ž… ์ถ”๋ก ์„ ์ œ์–ดํ•  ์ˆ˜ ์žˆ๋Š” ์ƒˆ๋กœ์šด ์œ ํ‹ธ๋ฆฌํ‹ฐ ํƒ€์ž…์ด ์ถ”๊ฐ€๋์–ด:
function createStreetLight<C extends string>(
  colors: C[],
  defaultColor?: NoInfer<C>
) {
  // ...
}

createStreetLight(["red", "yellow", "green"], "blue");
// ์—๋Ÿฌ! "blue"๋Š” colors ๋ฐฐ์—ด์— ์—†์Œ
2. Preserved Narrowing in Closures
ํด๋กœ์ € ๋‚ด๋ถ€์—์„œ ํƒ€์ž… ์ขํžˆ๊ธฐ๊ฐ€ ๋” ์ž˜ ์œ ์ง€๋˜๊ฒŒ ๊ฐœ์„ ๋์–ด. ์ด์ „์—๋Š” ํด๋กœ์ € ์•ˆ์—์„œ ํƒ€์ž…์ด ๋‹ค์‹œ ๋„“์–ด์ง€๋Š” ๋ฌธ์ œ๊ฐ€ ์žˆ์—ˆ๋Š”๋ฐ, ์ด์ œ๋Š” ๊ทธ๋Ÿฐ ๋ฌธ์ œ๊ฐ€ ๋งŽ์ด ํ•ด๊ฒฐ๋์ง€.

TypeScript 5.5 (2024๋…„ 6์›”)

1. Inferred Type Predicates
ํƒ€์ž… ๊ฐ€๋“œ ํ•จ์ˆ˜์—์„œ ๋ฐ˜ํ™˜ ํƒ€์ž…์„ ์ž๋™์œผ๋กœ ์ถ”๋ก ํ•ด์ค˜:
function isString(value: unknown) {
  return typeof value === "string";
  // ๋ฐ˜ํ™˜ ํƒ€์ž…์ด ์ž๋™์œผ๋กœ 'value is string'์œผ๋กœ ์ถ”๋ก ๋จ
}

const values = ["hello", 42, "world", true];
const strings = values.filter(isString);
// strings์˜ ํƒ€์ž…์ด string[]๋กœ ์ •ํ™•ํžˆ ์ถ”๋ก ๋จ!
2. Control Flow Narrowing for Constant Indexed Accesses
์ƒ์ˆ˜ ์ธ๋ฑ์Šค ์ ‘๊ทผ์—์„œ ์ œ์–ด ํ๋ฆ„ ๋ถ„์„์ด ๊ฐœ์„ ๋์–ด. ์ด๊ฒŒ ๋ฌด์Šจ ๋ง์ด๋ƒ๋ฉด:
function processData(data: { status: "success"; value: number } | { status: "error"; error: string }) {
  const status = data.status;
  
  if (status === "success") {
    console.log(data.value);  // ์ด์ œ ์—๋Ÿฌ๊ฐ€ ์•ˆ ๋‚จ!
  }
}
์ด์ „์—๋Š” ์ด๋Ÿฐ ํŒจํ„ด์—์„œ ํƒ€์ž… ์ขํžˆ๊ธฐ๊ฐ€ ์ œ๋Œ€๋กœ ์ž‘๋™ํ•˜์ง€ ์•Š์•˜๋Š”๋ฐ, ์ด์ œ๋Š” ์™„๋ฒฝํ•˜๊ฒŒ ์ž‘๋™ํ•ด. ๐ŸŽ‰

๐Ÿ”ฎ ์ฐจ์„ธ๋Œ€ ํƒ€์ž… ์‹œ์Šคํ…œ ๋ฐœ์ „ ๋ฐฉํ–ฅ

์ž, ์ด์ œ ๊ฐ€์žฅ ํฅ๋ฏธ๋กœ์šด ๋ถ€๋ถ„์ด์•ผ. ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ๋ฏธ๋ž˜๋Š” ์–ด๋–ป๊ฒŒ ๋ ๊นŒ? ํ˜„์žฌ ๋…ผ์˜๋˜๊ณ  ์žˆ๋Š” ๊ฒƒ๋“ค๊ณผ ์˜ˆ์ƒ๋˜๋Š” ๋ฐœ์ „ ๋ฐฉํ–ฅ์„ ์‚ดํŽด๋ณด์ž. ๐ŸŒŸ

1. ๋” ๊ฐ•๋ ฅํ•œ ํƒ€์ž… ์ถ”๋ก 

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ํŒ€์€ ๊ณ„์†ํ•ด์„œ ํƒ€์ž… ์ถ”๋ก ์„ ๊ฐœ์„ ํ•˜๊ณ  ์žˆ์–ด. ํŠนํžˆ ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๋ฐฉํ–ฅ์œผ๋กœ ๋ฐœ์ „ํ•˜๊ณ  ์žˆ์ง€:

Higher-Kinded Types (๊ณ ์ฐจ ํƒ€์ž…)
ํ˜„์žฌ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋Š” ๊ณ ์ฐจ ํƒ€์ž…์„ ์™„์ „ํžˆ ์ง€์›ํ•˜์ง€ ์•Š์•„. ํ•˜์ง€๋งŒ ์ปค๋ฎค๋‹ˆํ‹ฐ์—์„œ๋Š” ์ด์— ๋Œ€ํ•œ ์š”๊ตฌ๊ฐ€ ๊ณ„์†๋˜๊ณ  ์žˆ๊ณ , ๋ถ€๋ถ„์ ์œผ๋กœ๋‚˜๋งˆ ์ง€์›๋  ๊ฐ€๋Šฅ์„ฑ์ด ์žˆ์–ด:
// ํ˜„์žฌ๋Š” ๋ถˆ๊ฐ€๋Šฅํ•˜์ง€๋งŒ, ๋ฏธ๋ž˜์—๋Š” ๊ฐ€๋Šฅํ•  ์ˆ˜๋„?
type Functor<F> = {
  map: <A, B>(fa: F<A>, f: (a: A) => B) => F<B>;
};

// ์ด๋ ‡๊ฒŒ Array, Promise ๋“ฑ์— ๊ณตํ†ต์œผ๋กœ ์ ์šฉํ•  ์ˆ˜ ์žˆ๋Š”
// ์ถ”์ƒํ™”๊ฐ€ ๊ฐ€๋Šฅํ•ด์งˆ ์ˆ˜ ์žˆ์–ด
๋” ์ •๊ตํ•œ ์ œ์–ด ํ๋ฆ„ ๋ถ„์„
ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ์ œ์–ด ํ๋ฆ„ ๋ถ„์„์€ ์ด๋ฏธ ๊ฐ•๋ ฅํ•˜์ง€๋งŒ, ์•ž์œผ๋กœ ๋” ๋ฐœ์ „ํ•  ๊ฑฐ์•ผ. ์˜ˆ๋ฅผ ๋“ค์–ด, ๋” ๋ณต์žกํ•œ ์กฐ๊ฑด๋ฌธ์ด๋‚˜ ๋ฃจํ”„์—์„œ๋„ ํƒ€์ž…์„ ์ •ํ™•ํžˆ ์ถ”๋ก ํ•  ์ˆ˜ ์žˆ๊ฒŒ ๋  ๊ฑฐ์•ผ.

2. ์„ฑ๋Šฅ ์ตœ์ ํ™”

๋Œ€๊ทœ๋ชจ ํ”„๋กœ์ ํŠธ์—์„œ ํƒ€์ž… ์ฒดํ‚น ์†๋„๋Š” ์ •๋ง ์ค‘์š”ํ•ด. ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ํŒ€์€ ๊ณ„์†ํ•ด์„œ ์„ฑ๋Šฅ์„ ๊ฐœ์„ ํ•˜๊ณ  ์žˆ์–ด:

์ฆ๋ถ„ ์ปดํŒŒ์ผ ๊ฐœ์„ 
๋ณ€๊ฒฝ๋œ ํŒŒ์ผ๋งŒ ๋‹ค์‹œ ์ฒดํฌํ•˜๋Š” ์ฆ๋ถ„ ์ปดํŒŒ์ผ์ด ๋”์šฑ ๋˜‘๋˜‘ํ•ด์งˆ ๊ฑฐ์•ผ. ํ˜„์žฌ๋„ --incremental ํ”Œ๋ž˜๊ทธ๊ฐ€ ์žˆ์ง€๋งŒ, ์•ž์œผ๋กœ๋Š” ๋” ์ •๊ตํ•ด์งˆ ์˜ˆ์ •์ด์•ผ.

๋ณ‘๋ ฌ ์ฒ˜๋ฆฌ
๋ฉ€ํ‹ฐ์ฝ”์–ด CPU๋ฅผ ๋” ํšจ์œจ์ ์œผ๋กœ ํ™œ์šฉํ•ด์„œ ํƒ€์ž… ์ฒดํ‚น์„ ๋ณ‘๋ ฌ๋กœ ์ฒ˜๋ฆฌํ•˜๋Š” ๋ฐฉํ–ฅ์œผ๋กœ ๋ฐœ์ „ํ•  ๊ฑฐ์•ผ. ์ด๋ฏธ ์ผ๋ถ€ ์‹คํ—˜์  ๊ธฐ๋Šฅ์ด ์žˆ๊ณ , ์•ž์œผ๋กœ ๋” ๊ฐœ์„ ๋  ์˜ˆ์ •์ด์•ผ. โšก

3. ๋” ๋‚˜์€ ์—๋Ÿฌ ๋ฉ”์‹œ์ง€

ํƒ€์ž… ์—๋Ÿฌ ๋ฉ”์‹œ์ง€๊ฐ€ ๋” ์นœ์ ˆํ•˜๊ณ  ์ดํ•ดํ•˜๊ธฐ ์‰ฌ์›Œ์งˆ ๊ฑฐ์•ผ. ํ˜„์žฌ๋„ ๋งŽ์ด ๊ฐœ์„ ๋์ง€๋งŒ, ๋ณต์žกํ•œ ์ œ๋„ค๋ฆญ ํƒ€์ž…์—์„œ๋Š” ์—ฌ์ „ํžˆ ์—๋Ÿฌ ๋ฉ”์‹œ์ง€๊ฐ€ ๋‚œํ•ดํ•  ๋•Œ๊ฐ€ ์žˆ๊ฑฐ๋“ :
ํ˜„์žฌ์˜ ์—๋Ÿฌ ๋ฉ”์‹œ์ง€ (๋ณต์žกํ•จ)
Type 'Promise<{ data: User[] }>' is not assignable to type 'Promise<{ data: User[] | undefined }>'...


๋ฏธ๋ž˜์˜ ์—๋Ÿฌ ๋ฉ”์‹œ์ง€ (๊ฐœ์„ ๋จ)
๐Ÿ’ก API ์‘๋‹ต ํƒ€์ž…์ด ์ผ์น˜ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. User ๋ฐฐ์—ด์ด undefined์ผ ์ˆ˜ ์žˆ๋Š”์ง€ ํ™•์ธํ•ด์ฃผ์„ธ์š”.

๐Ÿ“ src/api/users.ts:42:10

4. ๋Ÿฐํƒ€์ž„ ํƒ€์ž… ๊ฒ€์ฆ๊ณผ์˜ ํ†ตํ•ฉ

ํ˜„์žฌ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ํƒ€์ž…์€ ์ปดํŒŒ์ผ ํƒ€์ž„์—๋งŒ ์กด์žฌํ•˜๊ณ  ๋Ÿฐํƒ€์ž„์—๋Š” ์‚ฌ๋ผ์ ธ. ํ•˜์ง€๋งŒ ์•ž์œผ๋กœ๋Š” ๋Ÿฐํƒ€์ž„ ํƒ€์ž… ๊ฒ€์ฆ๊ณผ ๋” ๊ธด๋ฐ€ํ•˜๊ฒŒ ํ†ตํ•ฉ๋  ๊ฐ€๋Šฅ์„ฑ์ด ์žˆ์–ด:

Type Guards ์ž๋™ ์ƒ์„ฑ
ํƒ€์ž… ์ •์˜๋กœ๋ถ€ํ„ฐ ๋Ÿฐํƒ€์ž„ ๊ฒ€์ฆ ์ฝ”๋“œ๋ฅผ ์ž๋™์œผ๋กœ ์ƒ์„ฑํ•˜๋Š” ๊ธฐ๋Šฅ์ด ์ถ”๊ฐ€๋  ์ˆ˜ ์žˆ์–ด:
// ๋ฏธ๋ž˜์—๋Š” ์ด๋Ÿฐ ์‹์œผ๋กœ?
interface User {
  name: string;
  age: number;
  email: string;
}

// ์ž๋™์œผ๋กœ ๋Ÿฐํƒ€์ž„ ๊ฒ€์ฆ ํ•จ์ˆ˜ ์ƒ์„ฑ
const validateUser = generateValidator<User>();

const data = await fetch("/api/user").then(r => r.json());
if (validateUser(data)) {
  // data๊ฐ€ User ํƒ€์ž…์ž„์ด ๋ณด์žฅ๋จ
  console.log(data.name);
}
๋ฌผ๋ก  ์ด๊ฑด ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์ž์ฒด๋ณด๋‹ค๋Š” Zod, io-ts ๊ฐ™์€ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋“ค์ด ๋” ์ž˜ํ•˜๊ณ  ์žˆ๋Š” ์˜์—ญ์ด๊ธด ํ•ด. ํ•˜์ง€๋งŒ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์™€ ๋” ๊ธด๋ฐ€ํ•˜๊ฒŒ ํ†ตํ•ฉ๋  ์ˆ˜๋Š” ์žˆ์„ ๊ฑฐ์•ผ.

5. ๋” ๋‚˜์€ ๋ชจ๋“ˆ ์‹œ์Šคํ…œ ์ง€์›

ECMAScript ๋ชจ๋“ˆ ์‹œ์Šคํ…œ์ด ๊ณ„์† ๋ฐœ์ „ํ•˜๊ณ  ์žˆ๊ณ , ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋„ ์ด์— ๋งž์ถฐ ๋ฐœ์ „ํ•  ๊ฑฐ์•ผ:

Import Attributes ํ™•์žฅ
๋‹ค์–‘ํ•œ ์ข…๋ฅ˜์˜ ๋ชจ๋“ˆ์„ ๋” ์•ˆ์ „ํ•˜๊ฒŒ importํ•  ์ˆ˜ ์žˆ๊ฒŒ ๋  ๊ฑฐ์•ผ. JSON, CSS, WebAssembly ๋“ฑ๋“ฑ.

Package Exports ๊ฐœ์„ 
package.json์˜ exports ํ•„๋“œ๋ฅผ ๋” ์ž˜ ์ง€์›ํ•˜๊ฒŒ ๋  ๊ฑฐ์•ผ. ์ด๋ฏธ ๋งŽ์ด ๊ฐœ์„ ๋์ง€๋งŒ, ์•ž์œผ๋กœ ๋” ์ข‹์•„์งˆ ์˜ˆ์ •์ด์•ผ. ๐Ÿ“ฆ

๐ŸŽฏ ์‹ค๋ฌด์—์„œ์˜ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ํ™œ์šฉ ํŒจํ„ด

์ด๋ก ์€ ์ถฉ๋ถ„ํžˆ ๋ดค์œผ๋‹ˆ, ์ด์ œ ์‹ค๋ฌด์—์„œ ์–ด๋–ป๊ฒŒ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋ฅผ ํšจ๊ณผ์ ์œผ๋กœ ํ™œ์šฉํ•  ์ˆ˜ ์žˆ๋Š”์ง€ ์‚ดํŽด๋ณด์ž. ๐Ÿ’ผ

1. API ์‘๋‹ต ํƒ€์ž… ์ •์˜

๋ฐฑ์—”๋“œ API์™€ ํ†ต์‹ ํ•  ๋•Œ ํƒ€์ž…์„ ์ž˜ ์ •์˜ํ•˜๋Š” ๊ฒŒ ์ •๋ง ์ค‘์š”ํ•ด. ์ด๋ ‡๊ฒŒ ํ•˜๋ฉด API ์‘๋‹ต ๊ตฌ์กฐ๊ฐ€ ๋ฐ”๋€Œ์—ˆ์„ ๋•Œ ๋ฐ”๋กœ ์•Œ ์ˆ˜ ์žˆ๊ฑฐ๋“ :
// API ์‘๋‹ต ํƒ€์ž… ์ •์˜
interface ApiResponse<T> {
  success: boolean;
  data?: T;
  error?: {
    code: string;
    message: string;
  };
}

interface User {
  id: number;
  name: string;
  email: string;
  createdAt: string;
}

// API ํ•จ์ˆ˜
async function fetchUser(id: number): Promise<ApiResponse<User>> {
  const response = await fetch(`/api/users/${id}`);
  return response.json();
}

// ์‚ฌ์šฉ
const result = await fetchUser(123);
if (result.success && result.data) {
  console.log(result.data.name);  // ํƒ€์ž… ์•ˆ์ „!
}

2. ์œ ํ‹ธ๋ฆฌํ‹ฐ ํƒ€์ž… ํ™œ์šฉ

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์—๋Š” ์ •๋ง ์œ ์šฉํ•œ ๋‚ด์žฅ ์œ ํ‹ธ๋ฆฌํ‹ฐ ํƒ€์ž…๋“ค์ด ๋งŽ์•„. ์ด๊ฑธ ์ž˜ ํ™œ์šฉํ•˜๋ฉด ์ฝ”๋“œ๊ฐ€ ํ›จ์”ฌ ๊น”๋”ํ•ด์ ธ:

Partial - ๋ชจ๋“  ์†์„ฑ์„ ์„ ํƒ์ ์œผ๋กœ
interface User {
  id: number;
  name: string;
  email: string;
  age: number;
}

// ์‚ฌ์šฉ์ž ์ •๋ณด ์—…๋ฐ์ดํŠธ ํ•จ์ˆ˜
function updateUser(id: number, updates: Partial<User>) {
  // updates๋Š” User์˜ ์ผ๋ถ€ ์†์„ฑ๋งŒ ๊ฐ€์งˆ ์ˆ˜ ์žˆ์Œ
}

updateUser(123, { name: "Alice" });  // OK
updateUser(123, { age: 30 });  // OK
Pick - ํŠน์ • ์†์„ฑ๋งŒ ์„ ํƒ
type UserPreview = Pick<User, "id" | "name">;
// { id: number; name: string; }

function showUserPreview(user: UserPreview) {
  console.log(`${user.id}: ${user.name}`);
}
Omit - ํŠน์ • ์†์„ฑ ์ œ์™ธ
type UserWithoutId = Omit<User, "id">;
// { name: string; email: string; age: number; }

function createUser(userData: UserWithoutId): User {
  return {
    id: generateId(),
    ...userData
  };
}
Record - ํ‚ค-๊ฐ’ ์Œ ํƒ€์ž…
type UserRole = "admin" | "user" | "guest";

const permissions: Record<UserRole, string[]> = {
  admin: ["read", "write", "delete"],
  user: ["read", "write"],
  guest: ["read"]
};

3. ์ œ๋„ค๋ฆญ ํ™œ์šฉ ํŒจํ„ด

์ œ๋„ค๋ฆญ์€ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ๊ฝƒ์ด์•ผ. ์žฌ์‚ฌ์šฉ ๊ฐ€๋Šฅํ•œ ์ปดํฌ๋„ŒํŠธ๋ฅผ ๋งŒ๋“ค ๋•Œ ํ•„์ˆ˜์ ์ด์ง€:

์ œ๋„ค๋ฆญ ํ•จ์ˆ˜
// ๋ฐฐ์—ด์˜ ์ฒซ ๋ฒˆ์งธ ์š”์†Œ๋ฅผ ๋ฐ˜ํ™˜ํ•˜๋Š” ํ•จ์ˆ˜
function first<T>(arr: T[]): T | undefined {
  return arr[0];
}

const numbers = [1, 2, 3];
const firstNum = first(numbers);  // number | undefined

const strings = ["a", "b", "c"];
const firstStr = first(strings);  // string | undefined
์ œ๋„ค๋ฆญ ํด๋ž˜์Šค
class DataStore<T> {
  private data: T[] = [];

  add(item: T): void {
    this.data.push(item);
  }

  get(index: number): T | undefined {
    return this.data[index];
  }

  getAll(): T[] {
    return [...this.data];
  }
}

const userStore = new DataStore<User>();
userStore.add({ id: 1, name: "Alice", email: "alice@example.com", age: 30 });

const productStore = new DataStore<Product>();
productStore.add({ id: 1, name: "Laptop", price: 1000 });
์ œ๋„ค๋ฆญ ์ œ์•ฝ ์กฐ๊ฑด
// T๋Š” ๋ฐ˜๋“œ์‹œ id ์†์„ฑ์„ ๊ฐ€์ ธ์•ผ ํ•จ
function findById<T extends { id: number }>(items: T[], id: number): T | undefined {
  return items.find(item => item.id === id);
}

const users: User[] = [
  { id: 1, name: "Alice", email: "alice@example.com", age: 30 },
  { id: 2, name: "Bob", email: "bob@example.com", age: 25 }
];

const user = findById(users, 1);  // User | undefined

4. ํƒ€์ž… ๊ฐ€๋“œ ํŒจํ„ด

๋Ÿฐํƒ€์ž„์— ํƒ€์ž…์„ ์ฒดํฌํ•˜๊ณ  ํƒ€์ž…์„ ์ขํžˆ๋Š” ํŒจํ„ด์ด์•ผ. ์ •๋ง ์œ ์šฉํ•ด:

typeof ํƒ€์ž… ๊ฐ€๋“œ
function processValue(value: string | number) {
  if (typeof value === "string") {
    // ์—ฌ๊ธฐ์„œ๋Š” value๊ฐ€ string
    console.log(value.toUpperCase());
  } else {
    // ์—ฌ๊ธฐ์„œ๋Š” value๊ฐ€ number
    console.log(value.toFixed(2));
  }
}
instanceof ํƒ€์ž… ๊ฐ€๋“œ
class Dog {
  bark() {
    console.log("Woof!");
  }
}

class Cat {
  meow() {
    console.log("Meow!");
  }
}

function makeSound(animal: Dog | Cat) {
  if (animal instanceof Dog) {
    animal.bark();
  } else {
    animal.meow();
  }
}
์‚ฌ์šฉ์ž ์ •์˜ ํƒ€์ž… ๊ฐ€๋“œ
interface Fish {
  swim: () => void;
}

interface Bird {
  fly: () => void;
}

// ํƒ€์ž… ๊ฐ€๋“œ ํ•จ์ˆ˜
function isFish(pet: Fish | Bird): pet is Fish {
  return (pet as Fish).swim !== undefined;
}

function move(pet: Fish | Bird) {
  if (isFish(pet)) {
    pet.swim();
  } else {
    pet.fly();
  }
}

5. Discriminated Unions (ํŒ๋ณ„๋œ ์œ ๋‹ˆ์˜จ)

์ด๊ฑด ์ •๋ง ๊ฐ•๋ ฅํ•œ ํŒจํ„ด์ด์•ผ. ์ƒํƒœ ๊ด€๋ฆฌ๋‚˜ ์—๋Ÿฌ ํ•ธ๋“ค๋ง์—์„œ ํŠนํžˆ ์œ ์šฉํ•ด:
type LoadingState = {
  status: "loading";
};

type SuccessState<T> = {
  status: "success";
  data: T;
};

type ErrorState = {
  status: "error";
  error: string;
};

type AsyncState<T> = LoadingState | SuccessState<T> | ErrorState;

function renderUser(state: AsyncState<User>) {
  switch (state.status) {
    case "loading":
      return "Loading...";
    case "success":
      return `User: ${state.data.name}`;  // state.data๊ฐ€ ์กด์žฌํ•จ์„ ๋ณด์žฅ
    case "error":
      return `Error: ${state.error}`;  // state.error๊ฐ€ ์กด์žฌํ•จ์„ ๋ณด์žฅ
  }
}
์ด ํŒจํ„ด์˜ ์žฅ์ ์€ status ํ•„๋“œ๋ฅผ ์ฒดํฌํ•˜๋ฉด ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๊ฐ€ ์ž๋™์œผ๋กœ ๋‹ค๋ฅธ ํ•„๋“œ๋“ค์˜ ํƒ€์ž…์„ ์ขํ˜€์ค€๋‹ค๋Š” ๊ฑฐ์•ผ. ์ •๋ง ๋˜‘๋˜‘ํ•˜์ง€? ๐Ÿง 

โš ๏ธ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์•ˆํ‹ฐํŒจํ„ด๊ณผ ์ฃผ์˜์‚ฌํ•ญ

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด์„œ ํ”ผํ•ด์•ผ ํ•  ํŒจํ„ด๋“ค๋„ ์•Œ์•„๋‘๋Š” ๊ฒŒ ์ค‘์š”ํ•ด. ์ด๋Ÿฐ ์‹ค์ˆ˜๋“ค์€ ์ดˆ๋ณด์ž๋ฟ๋งŒ ์•„๋‹ˆ๋ผ ๊ฒฝํ—˜ ์žˆ๋Š” ๊ฐœ๋ฐœ์ž๋“ค๋„ ์ž์ฃผ ํ•˜๊ฑฐ๋“ . ๐Ÿšซ

1. any ํƒ€์ž… ๋‚จ์šฉ

any๋Š” ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ํƒ€์ž… ์‹œ์Šคํ…œ์„ ์™„์ „ํžˆ ๋ฌด๋ ฅํ™”์‹œ์ผœ. ์ •๋ง ํ•„์š”ํ•œ ๊ฒฝ์šฐ๊ฐ€ ์•„๋‹ˆ๋ฉด ์‚ฌ์šฉํ•˜์ง€ ๋ง์ž:
// โŒ ๋‚˜์œ ์˜ˆ
function processData(data: any) {
  return data.value.toString();  // ๋Ÿฐํƒ€์ž„ ์—๋Ÿฌ ๊ฐ€๋Šฅ์„ฑ
}

// โœ… ์ข‹์€ ์˜ˆ
function processData(data: { value: number | string }) {
  return data.value.toString();  // ํƒ€์ž… ์•ˆ์ „
}

// ๋˜๋Š” ์ œ๋„ค๋ฆญ ์‚ฌ์šฉ
function processData<T extends { value: number | string }>(data: T) {
  return data.value.toString();
}
any ๋Œ€์‹  unknown์„ ์‚ฌ์šฉํ•˜๋Š” ๊ฒƒ๋„ ์ข‹์€ ๋ฐฉ๋ฒ•์ด์•ผ. unknown์€ ํƒ€์ž…์„ ์ฒดํฌํ•˜๊ธฐ ์ „๊นŒ์ง€๋Š” ์•„๋ฌด๊ฒƒ๋„ ํ•  ์ˆ˜ ์—†๊ฒŒ ๋งŒ๋“ค์–ด:

2. ํƒ€์ž… ๋‹จ์–ธ(Type Assertion) ๊ณผ๋‹ค ์‚ฌ์šฉ

ํƒ€์ž… ๋‹จ์–ธ(as)์€ "๋‚ด๊ฐ€ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋ณด๋‹ค ๋” ์ž˜ ์•Œ์•„!"๋ผ๊ณ  ์„ ์–ธํ•˜๋Š” ๊ฑฐ์•ผ. ํ•˜์ง€๋งŒ ์ด๊ฒŒ ํ‹€๋ ธ์„ ๋•Œ ๋ฌธ์ œ๊ฐ€ ์ƒ๊ธฐ์ง€:
// โŒ ๋‚˜์œ ์˜ˆ
const data = JSON.parse(jsonString) as User;
// JSON์ด ์ •๋ง User ํ˜•ํƒœ์ผ๊นŒ? ๋ณด์žฅํ•  ์ˆ˜ ์—†์Œ

// โœ… ์ข‹์€ ์˜ˆ
function isUser(obj: any): obj is User {
  return (
    typeof obj === "object" &&
    typeof obj.id === "number" &&
    typeof obj.name === "string" &&
    typeof obj.email === "string"
  );
}

const data = JSON.parse(jsonString);
if (isUser(data)) {
  // ์ด์ œ ์•ˆ์ „ํ•˜๊ฒŒ ์‚ฌ์šฉ ๊ฐ€๋Šฅ
  console.log(data.name);
}

3. ํƒ€์ž…๊ณผ ์ธํ„ฐํŽ˜์ด์Šค ํ˜ผ์šฉ

type๊ณผ interface๋Š” ๋น„์Šทํ•˜์ง€๋งŒ ์ฐจ์ด๊ฐ€ ์žˆ์–ด. ์ผ๊ด€์„ฑ ์žˆ๊ฒŒ ์‚ฌ์šฉํ•˜๋Š” ๊ฒŒ ์ข‹์•„:

์ธํ„ฐํŽ˜์ด์Šค๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๊ฒŒ ์ข‹์€ ๊ฒฝ์šฐ:
- ๊ฐ์ฒด์˜ ํ˜•ํƒœ๋ฅผ ์ •์˜ํ•  ๋•Œ
- ํ™•์žฅ(extends)์ด ํ•„์š”ํ•  ๋•Œ
- ์„ ์–ธ ๋ณ‘ํ•ฉ(Declaration Merging)์ด ํ•„์š”ํ•  ๋•Œ

ํƒ€์ž…์„ ์‚ฌ์šฉํ•˜๋Š” ๊ฒŒ ์ข‹์€ ๊ฒฝ์šฐ:
- ์œ ๋‹ˆ์˜จ ํƒ€์ž…์ด๋‚˜ ๊ต์ฐจ ํƒ€์ž…์„ ๋งŒ๋“ค ๋•Œ
- ํŠœํ”Œ์ด๋‚˜ ํ•จ์ˆ˜ ํƒ€์ž…์„ ์ •์˜ํ•  ๋•Œ
- ๋งคํ•‘๋œ ํƒ€์ž…์ด๋‚˜ ์กฐ๊ฑด๋ถ€ ํƒ€์ž…์„ ์‚ฌ์šฉํ•  ๋•Œ
// ๊ฐ์ฒด ํ˜•ํƒœ ์ •์˜ - interface ์„ ํ˜ธ
interface User {
  id: number;
  name: string;
}

// ์œ ๋‹ˆ์˜จ ํƒ€์ž… - type ์‚ฌ์šฉ
type Status = "pending" | "success" | "error";

// ํ•จ์ˆ˜ ํƒ€์ž… - type ์‚ฌ์šฉ
type Callback = (data: string) => void;

4. ๋ถˆํ•„์š”ํ•œ ํƒ€์ž… ์ •์˜

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ํƒ€์ž… ์ถ”๋ก ์ด ์ถฉ๋ถ„ํžˆ ๋˜‘๋˜‘ํ•˜๋‹ˆ๊นŒ, ๋ช…๋ฐฑํ•œ ๊ฒฝ์šฐ์—๋Š” ํƒ€์ž…์„ ์ƒ๋žตํ•˜๋Š” ๊ฒŒ ์˜คํžˆ๋ ค ์ข‹์•„:
// โŒ ๋ถˆํ•„์š”ํ•œ ํƒ€์ž… ๋ช…์‹œ
const name: string = "Alice";
const age: number = 30;
const isActive: boolean = true;

// โœ… ํƒ€์ž… ์ถ”๋ก  ํ™œ์šฉ
const name = "Alice";  // string์œผ๋กœ ์ถ”๋ก 
const age = 30;  // number๋กœ ์ถ”๋ก 
const isActive = true;  // boolean์œผ๋กœ ์ถ”๋ก 

// ํ•˜์ง€๋งŒ ํ•จ์ˆ˜ ๋งค๊ฐœ๋ณ€์ˆ˜๋Š” ๋ช…์‹œํ•˜๋Š” ๊ฒŒ ์ข‹์Œ
function greet(name: string) {  // ์ด๊ฑด ๋ช…์‹œํ•ด์•ผ ํ•จ
  return `Hello, ${name}!`;
}

5. ํƒ€์ž… ์ •์˜ ํŒŒ์ผ ๊ด€๋ฆฌ ์†Œํ™€

๋Œ€๊ทœ๋ชจ ํ”„๋กœ์ ํŠธ์—์„œ๋Š” ํƒ€์ž… ์ •์˜๋ฅผ ์ž˜ ๊ด€๋ฆฌํ•˜๋Š” ๊ฒŒ ์ •๋ง ์ค‘์š”ํ•ด. ํƒ€์ž… ์ •์˜ ํŒŒ์ผ์„ ์ฒด๊ณ„์ ์œผ๋กœ ๊ตฌ์กฐํ™”ํ•˜์ž:
// types/user.ts
export interface User {
  id: number;
  name: string;
  email: string;
}

export type UserRole = "admin" | "user" | "guest";

// types/api.ts
export interface ApiResponse<T> {
  success: boolean;
  data?: T;
  error?: ApiError;
}

export interface ApiError {
  code: string;
  message: string;
}

// types/index.ts
export * from "./user";
export * from "./api";
๐Ÿ’ก ํƒ€์ž… ์ •์˜ ๊ด€๋ฆฌ ํŒ 1. ๋„๋ฉ”์ธ๋ณ„๋กœ ํƒ€์ž… ํŒŒ์ผ์„ ๋ถ„๋ฆฌํ•˜์ž
2. ๊ณตํ†ต์œผ๋กœ ์‚ฌ์šฉ๋˜๋Š” ํƒ€์ž…์€ ๋ณ„๋„ ํŒŒ์ผ๋กœ ๊ด€๋ฆฌ
3. ํƒ€์ž… ์ด๋ฆ„์€ ๋ช…ํ™•ํ•˜๊ณ  ์ผ๊ด€์„ฑ ์žˆ๊ฒŒ
4. JSDoc ์ฃผ์„์œผ๋กœ ํƒ€์ž…์— ๋Œ€ํ•œ ์„ค๋ช… ์ถ”๊ฐ€
5. ๋„ˆ๋ฌด ๋ณต์žกํ•œ ํƒ€์ž…์€ ์—ฌ๋Ÿฌ ๊ฐœ๋กœ ๋ถ„๋ฆฌํ•˜๋Š” ๊ฒŒ ์ข‹์•„ ๐Ÿ“

๐Ÿ› ๏ธ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ๊ฐœ๋ฐœ ํ™˜๊ฒฝ ์ตœ์ ํ™”

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋ฅผ ํšจ์œจ์ ์œผ๋กœ ์‚ฌ์šฉํ•˜๋ ค๋ฉด ๊ฐœ๋ฐœ ํ™˜๊ฒฝ ์„ค์ •๋„ ์ค‘์š”ํ•ด. ๋ช‡ ๊ฐ€์ง€ ํŒ์„ ๊ณต์œ ํ• ๊ฒŒ. โš™๏ธ

1. tsconfig.json ์„ค์ •

tsconfig.json์€ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ํ”„๋กœ์ ํŠธ์˜ ํ•ต์‹ฌ ์„ค์ • ํŒŒ์ผ์ด์•ผ. ์ œ๋Œ€๋กœ ์„ค์ •ํ•˜๋ฉด ๊ฐœ๋ฐœ ๊ฒฝํ—˜์ด ํ›จ์”ฌ ์ข‹์•„์ ธ:
{
  "compilerOptions": {
    // ์—„๊ฒฉํ•œ ํƒ€์ž… ์ฒดํ‚น ํ™œ์„ฑํ™”
    "strict": true,
    "noImplicitAny": true,
    "strictNullChecks": true,
    "strictFunctionTypes": true,
    "strictBindCallApply": true,
    "strictPropertyInitialization": true,
    "noImplicitThis": true,
    "alwaysStrict": true,
    
    // ์ถ”๊ฐ€ ์ฒดํฌ
    "noUnusedLocals": true,
    "noUnusedParameters": true,
    "noImplicitReturns": true,
    "noFallthroughCasesInSwitch": true,
    
    // ๋ชจ๋“ˆ ์„ค์ •
    "module": "ESNext",
    "moduleResolution": "bundler",
    "target": "ES2022",
    
    // ๊ฒฝ๋กœ ๋ณ„์นญ
    "baseUrl": ".",
    "paths": {
      "@/*": ["src/*"],
      "@components/*": ["src/components/*"],
      "@utils/*": ["src/utils/*"]
    },
    
    // ๊ธฐํƒ€
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist"]
}

2. ESLint์™€ Prettier ํ†ตํ•ฉ

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์™€ ESLint, Prettier๋ฅผ ํ•จ๊ป˜ ์‚ฌ์šฉํ•˜๋ฉด ์ฝ”๋“œ ํ’ˆ์งˆ์ด ํฌ๊ฒŒ ํ–ฅ์ƒ๋ผ:
// .eslintrc.json
{
  "parser": "@typescript-eslint/parser",
  "extends": [
    "eslint:recommended",
    "plugin:@typescript-eslint/recommended",
    "plugin:@typescript-eslint/recommended-requiring-type-checking",
    "prettier"
  ],
  "plugins": ["@typescript-eslint"],
  "parserOptions": {
    "project": "./tsconfig.json"
  },
  "rules": {
    "@typescript-eslint/no-unused-vars": "error",
    "@typescript-eslint/no-explicit-any": "warn",
    "@typescript-eslint/explicit-function-return-type": "off"
  }
}

3. VS Code ํ™•์žฅ ํ”„๋กœ๊ทธ๋žจ

VS Code๋ฅผ ์‚ฌ์šฉํ•œ๋‹ค๋ฉด ์ด ํ™•์žฅ ํ”„๋กœ๊ทธ๋žจ๋“ค์€ ํ•„์ˆ˜์•ผ:

ESLint Prettier Error Lens Pretty TypeScript Errors TypeScript Importer

ํŠนํžˆ Pretty TypeScript Errors๋Š” ๋ณต์žกํ•œ ํƒ€์ž… ์—๋Ÿฌ๋ฅผ ์ฝ๊ธฐ ์‰ฝ๊ฒŒ ๋งŒ๋“ค์–ด์ค˜์„œ ์ •๋ง ์œ ์šฉํ•ด. โœจ

4. ๋นŒ๋“œ ๋„๊ตฌ ์„ค์ •

Vite ์‚ฌ์šฉ ์‹œ
// vite.config.ts
import { defineConfig } from 'vite';
import react from '@vitejs/plugin-react';
import path from 'path';

export default defineConfig({
  plugins: [react()],
  resolve: {
    alias: {
      '@': path.resolve(__dirname, './src'),
      '@components': path.resolve(__dirname, './src/components'),
      '@utils': path.resolve(__dirname, './src/utils')
    }
  },
  build: {
    target: 'es2022',
    sourcemap: true
  }
});
Webpack ์‚ฌ์šฉ ์‹œ
// webpack.config.js
module.exports = {
  module: {
    rules: [
      {
        test: /\.tsx?$/,
        use: 'ts-loader',
        exclude: /node_modules/
      }
    ]
  },
  resolve: {
    extensions: ['.tsx', '.ts', '.js'],
    alias: {
      '@': path.resolve(__dirname, 'src/'),
      '@components': path.resolve(__dirname, 'src/components/'),
      '@utils': path.resolve(__dirname, 'src/utils/')
    }
  }
};

๐ŸŒ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์ƒํƒœ๊ณ„์™€ ๋„๊ตฌ๋“ค

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์ฃผ๋ณ€์—๋Š” ์ •๋ง ํ’๋ถ€ํ•œ ์ƒํƒœ๊ณ„๊ฐ€ ํ˜•์„ฑ๋˜์–ด ์žˆ์–ด. ์œ ์šฉํ•œ ๋„๊ตฌ๋“ค์„ ์†Œ๊ฐœํ• ๊ฒŒ. ๐Ÿ”ง

1. ํƒ€์ž… ์ •์˜ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ

DefinitelyTyped (@types)
์ž๋ฐ”์Šคํฌ๋ฆฝํŠธ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋“ค์˜ ํƒ€์ž… ์ •์˜๋ฅผ ์ œ๊ณตํ•˜๋Š” ๊ฑฐ๋Œ€ํ•œ ์ €์žฅ์†Œ์•ผ. npm์—์„œ @types/ ์ ‘๋‘์‚ฌ๋กœ ์„ค์น˜ํ•  ์ˆ˜ ์žˆ์–ด:
npm install --save-dev @types/react
npm install --save-dev @types/node
npm install --save-dev @types/lodash
ํ˜„์žฌ 8,000๊ฐœ ์ด์ƒ์˜ ํŒจํ‚ค์ง€์— ๋Œ€ํ•œ ํƒ€์ž… ์ •์˜๊ฐ€ ์žˆ์–ด. ์ •๋ง ๋Œ€๋‹จํ•˜์ง€? ๐Ÿ“š

2. ๋Ÿฐํƒ€์ž„ ํƒ€์ž… ๊ฒ€์ฆ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ

Zod
๊ฐ€์žฅ ์ธ๊ธฐ ์žˆ๋Š” ์Šคํ‚ค๋งˆ ๊ฒ€์ฆ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์•ผ. ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์™€ ์™„๋ฒฝํ•˜๊ฒŒ ํ†ตํ•ฉ๋ผ:
import { z } from 'zod';

const UserSchema = z.object({
  id: z.number(),
  name: z.string(),
  email: z.string().email(),
  age: z.number().min(0).max(120)
});

type User = z.infer<typeof UserSchema>;

// ๋Ÿฐํƒ€์ž„ ๊ฒ€์ฆ
const result = UserSchema.safeParse(data);
if (result.success) {
  const user: User = result.data;
  console.log(user.name);
}
io-ts
ํ•จ์ˆ˜ํ˜• ํ”„๋กœ๊ทธ๋ž˜๋ฐ ์Šคํƒ€์ผ์˜ ํƒ€์ž… ๊ฒ€์ฆ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์•ผ:

Yup
ํผ ๊ฒ€์ฆ์— ํŠนํ™”๋œ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋กœ, React Hook Form ๊ฐ™์€ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์™€ ์ž˜ ์–ด์šธ๋ ค.

3. ์œ ํ‹ธ๋ฆฌํ‹ฐ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ

type-fest
ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์œ ํ‹ธ๋ฆฌํ‹ฐ ํƒ€์ž… ๋ชจ์Œ์ง‘์ด์•ผ. ๋‚ด์žฅ ์œ ํ‹ธ๋ฆฌํ‹ฐ ํƒ€์ž…๋ณด๋‹ค ๋” ๋‹ค์–‘ํ•œ ๊ธฐ๋Šฅ์„ ์ œ๊ณตํ•ด:
import type { Simplify, PartialDeep, ReadonlyDeep } from 'type-fest';

// ๋ณต์žกํ•œ ํƒ€์ž…์„ ๋‹จ์ˆœํ™”
type SimplifiedUser = Simplify<User & UserProfile & UserSettings>;

// ๊นŠ์€ ๋ถ€๋ถ„ ํƒ€์ž…
type PartialUser = PartialDeep<User>;

// ๊นŠ์€ ์ฝ๊ธฐ ์ „์šฉ
type ImmutableUser = ReadonlyDeep<User>;
ts-pattern
ํŒจํ„ด ๋งค์นญ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋กœ, ๋ณต์žกํ•œ ์กฐ๊ฑด ๋ถ„๊ธฐ๋ฅผ ์šฐ์•„ํ•˜๊ฒŒ ์ฒ˜๋ฆฌํ•  ์ˆ˜ ์žˆ์–ด:
import { match } from 'ts-pattern';

const result = match(state)
  .with({ status: 'loading' }, () => 'Loading...')
  .with({ status: 'success' }, ({ data }) => `Success: ${data}`)
  .with({ status: 'error' }, ({ error }) => `Error: ${error}`)
  .exhaustive();

4. ๋ฌธ์„œํ™” ๋„๊ตฌ

TypeDoc
ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์ฝ”๋“œ๋กœ๋ถ€ํ„ฐ ์ž๋™์œผ๋กœ ๋ฌธ์„œ๋ฅผ ์ƒ์„ฑํ•ด์ฃผ๋Š” ๋„๊ตฌ์•ผ. JSDoc ์ฃผ์„์„ ๊ธฐ๋ฐ˜์œผ๋กœ ์ž‘๋™ํ•ด:
/**
 * ์‚ฌ์šฉ์ž ์ •๋ณด๋ฅผ ๊ฐ€์ ธ์˜ต๋‹ˆ๋‹ค.
 * @param id - ์‚ฌ์šฉ์ž ID
 * @returns ์‚ฌ์šฉ์ž ๊ฐ์ฒด ๋˜๋Š” undefined
 * @example
 * ```ts
 * const user = await fetchUser(123);
 * console.log(user?.name);
 * ```
 */
async function fetchUser(id: number): Promise<User | undefined> {
  // ...
}

5. ํ…Œ์ŠคํŒ… ๋„๊ตฌ

ts-jest
Jest์—์„œ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋ฅผ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๊ฒŒ ํ•ด์ฃผ๋Š” ํ”„๋ฆฌ์…‹์ด์•ผ:

Vitest
Vite ๊ธฐ๋ฐ˜์˜ ์ดˆ๊ณ ์† ํ…Œ์ŠคํŠธ ๋Ÿฌ๋„ˆ๋กœ, ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋ฅผ ๊ธฐ๋ณธ ์ง€์›ํ•ด. ์š”์ฆ˜ ์ •๋ง ์ธ๊ธฐ๊ฐ€ ๋งŽ์•„. โšก

๐Ÿ“ˆ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ ์ „๋žต

๊ธฐ์กด ์ž๋ฐ”์Šคํฌ๋ฆฝํŠธ ํ”„๋กœ์ ํŠธ๋ฅผ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋กœ ์ „ํ™˜ํ•˜๋Š” ๊ฑด ํฐ ๊ฒฐ์ •์ด์•ผ. ๋‹จ๊ณ„๋ณ„๋กœ ์ ‘๊ทผํ•˜๋Š” ๊ฒŒ ์ค‘์š”ํ•ด. ๐Ÿš€

1. ์ ์ง„์  ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜

ํ•œ ๋ฒˆ์— ๋ชจ๋“  ๊ฑธ ๋ฐ”๊พธ๋ ค๊ณ  ํ•˜์ง€ ๋งˆ. ์ ์ง„์ ์œผ๋กœ ์ ‘๊ทผํ•˜๋Š” ๊ฒŒ ํ›จ์”ฌ ์•ˆ์ „ํ•ด:

1๋‹จ๊ณ„: ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์„ค์ •
// tsconfig.json (์ดˆ๊ธฐ ์„ค์ •)
{
  "compilerOptions": {
    "allowJs": true,  // JS ํŒŒ์ผ ํ—ˆ์šฉ
    "checkJs": false,  // JS ํŒŒ์ผ ์ฒดํฌ ์•ˆ ํ•จ
    "strict": false,  // ์—„๊ฒฉ ๋ชจ๋“œ ๋น„ํ™œ์„ฑํ™”
    "noEmit": true,  // ์ปดํŒŒ์ผ ๊ฒฐ๊ณผ ์ƒ์„ฑ ์•ˆ ํ•จ
    "esModuleInterop": true,
    "skipLibCheck": true
  },
  "include": ["src/**/*"]
}
2๋‹จ๊ณ„: ํŒŒ์ผ ํ™•์žฅ์ž ๋ณ€๊ฒฝ
.js ํŒŒ์ผ์„ .ts๋กœ, .jsx ํŒŒ์ผ์„ .tsx๋กœ ํ•˜๋‚˜์”ฉ ๋ณ€๊ฒฝํ•ด. ์ค‘์š”ํ•œ ๊ฑด ์ž‘์€ ํŒŒ์ผ๋ถ€ํ„ฐ ์‹œ์ž‘ํ•˜๋Š” ๊ฑฐ์•ผ.

3๋‹จ๊ณ„: ํƒ€์ž… ์ถ”๊ฐ€
์—๋Ÿฌ๊ฐ€ ๋‚˜๋Š” ๋ถ€๋ถ„๋ถ€ํ„ฐ ํƒ€์ž…์„ ์ถ”๊ฐ€ํ•ด. ์ฒ˜์Œ์—๋Š” any๋ฅผ ์‚ฌ์šฉํ•ด๋„ ๊ดœ์ฐฎ์•„. ๋‚˜์ค‘์— ๊ฐœ์„ ํ•˜๋ฉด ๋ผ.

4๋‹จ๊ณ„: ์—„๊ฒฉ ๋ชจ๋“œ ํ™œ์„ฑํ™”
๋ชจ๋“  ํŒŒ์ผ์ด ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋กœ ์ „ํ™˜๋˜๋ฉด, ์ ์ง„์ ์œผ๋กœ ์—„๊ฒฉ ๋ชจ๋“œ๋ฅผ ํ™œ์„ฑํ™”ํ•ด:
// tsconfig.json (์ตœ์ข… ์„ค์ •)
{
  "compilerOptions": {
    "strict": true,
    "noImplicitAny": true,
    "strictNullChecks": true,
    // ... ๋‹ค๋ฅธ ์—„๊ฒฉ ์˜ต์…˜๋“ค
  }
}

2. ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ ์šฐ์„ ์ˆœ์œ„

์–ด๋–ค ํŒŒ์ผ๋ถ€ํ„ฐ ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ํ• ์ง€ ์ „๋žต์„ ์„ธ์šฐ๋Š” ๊ฒŒ ์ค‘์š”ํ•ด:

๋†’์€ ์šฐ์„ ์ˆœ์œ„:
1. ์œ ํ‹ธ๋ฆฌํ‹ฐ ํ•จ์ˆ˜๋“ค (์˜์กด์„ฑ์ด ์ ์Œ)
2. ํƒ€์ž… ์ •์˜ ํŒŒ์ผ๋“ค
3. ์ƒ์ˆ˜ ํŒŒ์ผ๋“ค
4. ํ•ต์‹ฌ ๋น„์ฆˆ๋‹ˆ์Šค ๋กœ์ง

๋‚ฎ์€ ์šฐ์„ ์ˆœ์œ„:
1. ๋ ˆ๊ฑฐ์‹œ ์ฝ”๋“œ
2. ๊ณง ์‚ญ์ œ๋  ์ฝ”๋“œ
3. ์™ธ๋ถ€ ์˜์กด์„ฑ์ด ๋งŽ์€ ์ฝ”๋“œ

3. ํŒ€ ๊ต์œก

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ๋„์ž…์€ ๊ธฐ์ˆ ์  ๋ฌธ์ œ๋งŒ์ด ์•„๋‹ˆ์•ผ. ํŒ€ ์ „์ฒด๊ฐ€ ํ•จ๊ป˜ ๋ฐฐ์›Œ์•ผ ํ•ด:

- ์ •๊ธฐ์ ์ธ ์Šคํ„ฐ๋”” ์„ธ์…˜ ์ง„ํ–‰
- ์ฝ”๋“œ ๋ฆฌ๋ทฐ์—์„œ ํƒ€์ž… ๊ด€๋ จ ํ”ผ๋“œ๋ฐฑ ๊ณต์œ 
- ๋ฒ ์ŠคํŠธ ํ”„๋ž™ํ‹ฐ์Šค ๋ฌธ์„œํ™”
- ํŽ˜์–ด ํ”„๋กœ๊ทธ๋ž˜๋ฐ์œผ๋กœ ์ง€์‹ ๊ณต์œ 

์žฌ๋Šฅ๋„ท์—์„œ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์ „๋ฌธ๊ฐ€์˜ ์ปจ์„คํŒ…์„ ๋ฐ›๋Š” ๊ฒƒ๋„ ์ข‹์€ ๋ฐฉ๋ฒ•์ด์•ผ. ์‹ค์ œ ํ”„๋กœ์ ํŠธ์— ์ ์šฉํ•˜๋ฉด์„œ ๋ฐฐ์šฐ๋Š” ๊ฒŒ ๊ฐ€์žฅ ํšจ๊ณผ์ ์ด๊ฑฐ๋“ . ๐Ÿ‘ฅ

๐Ÿ’ก ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ ์ฒดํฌ๋ฆฌ์ŠคํŠธ

โœ… ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์„ค์น˜ ๋ฐ ์„ค์ •
โœ… ๋นŒ๋“œ ๋„๊ตฌ ์„ค์ • (Webpack, Vite ๋“ฑ)
โœ… ESLint, Prettier ์„ค์ •
โœ… CI/CD ํŒŒ์ดํ”„๋ผ์ธ ์—…๋ฐ์ดํŠธ
โœ… ํƒ€์ž… ์ •์˜ ํŒŒ์ผ ์„ค์น˜ (@types/*)
โœ… ํŒ€ ๊ต์œก ๋ฐ ๋ฌธ์„œํ™”
โœ… ์ ์ง„์  ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ ๊ณ„ํš ์ˆ˜๋ฆฝ
โœ… ์ฝ”๋“œ ๋ฆฌ๋ทฐ ํ”„๋กœ์„ธ์Šค ์—…๋ฐ์ดํŠธ
โœ… ํ…Œ์ŠคํŠธ ํ™˜๊ฒฝ ์„ค์ •
โœ… ์„ฑ๋Šฅ ๋ชจ๋‹ˆํ„ฐ๋ง ์„ค์ •

๐ŸŽ“ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ํ•™์Šต ๋กœ๋“œ๋งต

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋ฅผ ์ฒ˜์Œ ๋ฐฐ์šฐ๋Š” ์‚ฌ๋žŒ๋“ค์„ ์œ„ํ•œ ํ•™์Šต ๋กœ๋“œ๋งต์„ ์ •๋ฆฌํ•ด๋ดค์–ด. ๐Ÿ“–

์ดˆ๊ธ‰ ๋‹จ๊ณ„ (1-2๊ฐœ์›”)

1์ฃผ์ฐจ: ๊ธฐ๋ณธ ํƒ€์ž…
- ๊ธฐ๋ณธ ํƒ€์ž…๋“ค (string, number, boolean, array, tuple)
- ํƒ€์ž… ์ถ”๋ก 
- ํƒ€์ž… ๋ช…์‹œ
- ํ•จ์ˆ˜ ํƒ€์ž…

2์ฃผ์ฐจ: ์ธํ„ฐํŽ˜์ด์Šค์™€ ํƒ€์ž… ๋ณ„์นญ
- interface vs type
- ๊ฐ์ฒด ํƒ€์ž… ์ •์˜
- ์„ ํƒ์  ์†์„ฑ
- ์ฝ๊ธฐ ์ „์šฉ ์†์„ฑ

3-4์ฃผ์ฐจ: ๊ณ ๊ธ‰ ํƒ€์ž…
- ์œ ๋‹ˆ์˜จ ํƒ€์ž…
- ๊ต์ฐจ ํƒ€์ž…
- ๋ฆฌํ„ฐ๋Ÿด ํƒ€์ž…
- ํƒ€์ž… ๊ฐ€๋“œ

5-8์ฃผ์ฐจ: ์‹ค์ „ ํ”„๋กœ์ ํŠธ
- ๊ฐ„๋‹จํ•œ Todo ์•ฑ ๋งŒ๋“ค๊ธฐ
- API ์—ฐ๋™ํ•˜๊ธฐ
- ์ƒํƒœ ๊ด€๋ฆฌ (Context API)
- ํผ ์ฒ˜๋ฆฌ

์ค‘๊ธ‰ ๋‹จ๊ณ„ (2-3๊ฐœ์›”)

์ œ๋„ค๋ฆญ
- ์ œ๋„ค๋ฆญ ํ•จ์ˆ˜
- ์ œ๋„ค๋ฆญ ํด๋ž˜์Šค
- ์ œ๋„ค๋ฆญ ์ œ์•ฝ ์กฐ๊ฑด
- ์ œ๋„ค๋ฆญ ์œ ํ‹ธ๋ฆฌํ‹ฐ ํƒ€์ž…

๊ณ ๊ธ‰ ํƒ€์ž… ๊ธฐ๋Šฅ
- ์กฐ๊ฑด๋ถ€ ํƒ€์ž…
- ๋งคํ•‘๋œ ํƒ€์ž…
- ํ…œํ”Œ๋ฆฟ ๋ฆฌํ„ฐ๋Ÿด ํƒ€์ž…
- infer ํ‚ค์›Œ๋“œ

์‹ค์ „ ํŒจํ„ด
- Discriminated Unions
- ํƒ€์ž… ์ขํžˆ๊ธฐ ํŒจํ„ด
- ๋นŒ๋” ํŒจํ„ด
- ํŒฉํ† ๋ฆฌ ํŒจํ„ด

๊ณ ๊ธ‰ ๋‹จ๊ณ„ (3๊ฐœ์›” ์ด์ƒ)

ํƒ€์ž… ์‹œ์Šคํ…œ ๊นŠ์ด ์ดํ•ด
- ๊ตฌ์กฐ์  ํƒ€์ดํ•‘ vs ๋ช…๋ชฉ์  ํƒ€์ดํ•‘
- ๊ณต๋ณ€์„ฑ๊ณผ ๋ฐ˜๊ณต๋ณ€์„ฑ
- ํƒ€์ž… ํ˜ธํ™˜์„ฑ
- ํƒ€์ž… ์‹œ์Šคํ…œ์˜ ํ•œ๊ณ„

๋Œ€๊ทœ๋ชจ ํ”„๋กœ์ ํŠธ ๊ด€๋ฆฌ
- ๋ชจ๋…ธ๋ ˆํฌ ๊ตฌ์กฐ
- ํƒ€์ž… ์ •์˜ ๊ด€๋ฆฌ
- ์„ฑ๋Šฅ ์ตœ์ ํ™”
- ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ ์ „๋žต

์ƒํƒœ๊ณ„ ๋„๊ตฌ ํ™œ์šฉ
- Zod, io-ts ๊ฐ™์€ ๋Ÿฐํƒ€์ž„ ๊ฒ€์ฆ
- type-fest ๊ฐ™์€ ์œ ํ‹ธ๋ฆฌํ‹ฐ
- TypeDoc์œผ๋กœ ๋ฌธ์„œํ™”
- ํ…Œ์ŠคํŒ… ์ „๋žต
๐Ÿ“š ์ถ”์ฒœ ํ•™์Šต ์ž๋ฃŒ ๊ณต์‹ ๋ฌธ์„œ: TypeScript ๊ณต์‹ ํ•ธ๋“œ๋ถ (ํ•œ๊ธ€ ๋ฒˆ์—ญ ์žˆ์Œ)
์ฑ…: "์ดํŽ™ํ‹ฐ๋ธŒ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ", "ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ํ”„๋กœ๊ทธ๋ž˜๋ฐ"
์˜จ๋ผ์ธ ๊ฐ•์˜: Udemy, ์ธํ”„๋Ÿฐ, ๋…ธ๋งˆ๋“œ์ฝ”๋”
์—ฐ์Šต: TypeScript Exercises, Type Challenges
์ปค๋ฎค๋‹ˆํ‹ฐ: TypeScript Discord, Reddit r/typescript

๊ทธ๋ฆฌ๊ณ  ์‹ค์ „ ํ”„๋กœ์ ํŠธ๋ฅผ ํ•˜๋ฉด์„œ ๋ง‰ํžˆ๋Š” ๋ถ€๋ถ„์ด ์žˆ๋‹ค๋ฉด, ์žฌ๋Šฅ๋„ท์—์„œ ๋ฉ˜ํ† ๋ฅผ ์ฐพ์•„๋ณด๋Š” ๊ฒƒ๋„ ์ข‹์€ ๋ฐฉ๋ฒ•์ด์•ผ! ๐ŸŽฏ

๐Ÿ”ฎ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ๋ฏธ๋ž˜ ์ „๋ง

๋งˆ์ง€๋ง‰์œผ๋กœ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ๋ฏธ๋ž˜์— ๋Œ€ํ•ด ์ด์•ผ๊ธฐํ•ด๋ณด์ž. ์•ž์œผ๋กœ ์–ด๋–ป๊ฒŒ ๋ฐœ์ „ํ• ๊นŒ? ๐ŸŒŸ

1. ECMAScript์™€์˜ ํ†ตํ•ฉ

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋Š” ๊ณ„์†ํ•ด์„œ ECMAScript ํ‘œ์ค€์„ ๋”ฐ๋ผ๊ฐ€๊ณ  ์žˆ์–ด. ์ตœ๊ทผ์—๋Š” ECMAScript ์ œ์•ˆ ๋‹จ๊ณ„์˜ ๊ธฐ๋Šฅ๋“ค๋„ ๋น ๋ฅด๊ฒŒ ์ง€์›ํ•˜๊ณ  ์žˆ์ง€. ์•ž์œผ๋กœ๋Š” ๋”์šฑ ๊ธด๋ฐ€ํ•˜๊ฒŒ ํ†ตํ•ฉ๋  ๊ฑฐ์•ผ.

ํŠนํžˆ ์ฃผ๋ชฉํ•  ๋งŒํ•œ ๊ฑด Type Annotations Proposal์ด์•ผ. ์ด๊ฑด ์ž๋ฐ”์Šคํฌ๋ฆฝํŠธ ์ž์ฒด์— ํƒ€์ž… ์ฃผ์„์„ ์ถ”๊ฐ€ํ•˜์ž๋Š” ์ œ์•ˆ์ธ๋ฐ, ๋งŒ์•ฝ ์ด๊ฒŒ ํ‘œ์ค€ํ™”๋˜๋ฉด ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์™€ ์ž๋ฐ”์Šคํฌ๋ฆฝํŠธ์˜ ๊ฒฝ๊ณ„๊ฐ€ ๋”์šฑ ํ๋ ค์งˆ ๊ฑฐ์•ผ. ๐Ÿ”„

2. ์„ฑ๋Šฅ ๊ฐœ์„ 

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ํŒ€์€ ๊ณ„์†ํ•ด์„œ ์ปดํŒŒ์ผ ์†๋„์™€ IDE ์„ฑ๋Šฅ์„ ๊ฐœ์„ ํ•˜๊ณ  ์žˆ์–ด. ํŠนํžˆ ๋Œ€๊ทœ๋ชจ ํ”„๋กœ์ ํŠธ์—์„œ์˜ ์„ฑ๋Šฅ์ด ํฌ๊ฒŒ ํ–ฅ์ƒ๋  ์˜ˆ์ •์ด์•ผ.

- ๋” ๋˜‘๋˜‘ํ•œ ์ฆ๋ถ„ ์ปดํŒŒ์ผ
- ๋ณ‘๋ ฌ ํƒ€์ž… ์ฒดํ‚น
- ๋ฉ”๋ชจ๋ฆฌ ์‚ฌ์šฉ๋Ÿ‰ ์ตœ์ ํ™”
- ์บ์‹ฑ ์ „๋žต ๊ฐœ์„ 

3. ๊ฐœ๋ฐœ์ž ๊ฒฝํ—˜ ํ–ฅ์ƒ

์—๋Ÿฌ ๋ฉ”์‹œ์ง€๊ฐ€ ๋” ์นœ์ ˆํ•ด์ง€๊ณ , IDE ํ†ตํ•ฉ์ด ๋” ๊ฐ•๋ ฅํ•ด์งˆ ๊ฑฐ์•ผ. ํŠนํžˆ AI ๊ธฐ๋ฐ˜ ์ฝ”๋“œ ์™„์„ฑ๊ณผ ํƒ€์ž… ์ถ”๋ก ์ด ๋ฐœ์ „ํ•˜๋ฉด์„œ, ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ๊ฐœ๋ฐœ์ด ๋”์šฑ ํŽธํ•ด์งˆ ๊ฑฐ์•ผ. ๐Ÿค–

4. ์ƒˆ๋กœ์šด ํƒ€์ž… ์‹œ์Šคํ…œ ๊ธฐ๋Šฅ

์•ž์œผ๋กœ ์ถ”๊ฐ€๋  ๊ฐ€๋Šฅ์„ฑ์ด ์žˆ๋Š” ๊ธฐ๋Šฅ๋“ค:

- ๋” ๊ฐ•๋ ฅํ•œ ํƒ€์ž… ์ถ”๋ก 
- ๊ณ ์ฐจ ํƒ€์ž… ์ง€์›
- ์˜์กด ํƒ€์ž… (Dependent Types) ๋ถ€๋ถ„ ์ง€์›
- ๋” ์ •๊ตํ•œ ์ œ์–ด ํ๋ฆ„ ๋ถ„์„
- ํšจ๊ณผ ์‹œ์Šคํ…œ (Effect System)

5. ์ƒํƒœ๊ณ„ ํ™•์žฅ

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์ƒํƒœ๊ณ„๋Š” ๊ณ„์† ์„ฑ์žฅํ•  ๊ฑฐ์•ผ. ํŠนํžˆ ๋‹ค์Œ ๋ถ„์•ผ์—์„œ ๋” ๋งŽ์€ ๋ฐœ์ „์ด ์˜ˆ์ƒ๋ผ:

๋ฐฑ์—”๋“œ: Node.js, Deno, Bun ๋“ฑ์—์„œ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๊ฐ€ 1๊ธ‰ ์‹œ๋ฏผ์œผ๋กœ ์ž๋ฆฌ์žก๊ณ  ์žˆ์–ด.

๋ชจ๋ฐ”์ผ: React Native, Ionic ๋“ฑ์—์„œ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์‚ฌ์šฉ์ด ํ‘œ์ค€์ด ๋˜๊ณ  ์žˆ์–ด.

๋ฐ์Šคํฌํ†ฑ: Electron, Tauri ๋“ฑ์—์„œ๋„ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๊ฐ€ ๋„๋ฆฌ ์‚ฌ์šฉ๋ผ.

ํด๋ผ์šฐ๋“œ: AWS CDK, Pulumi ๊ฐ™์€ IaC ๋„๊ตฌ๋“ค๋„ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋ฅผ ์ง€์›ํ•ด. โ˜๏ธ

6. ๊ฒฝ์Ÿ ๊ธฐ์ˆ ๋“ค

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ์„ฑ๊ณต์„ ๋ณด๊ณ  ๋น„์Šทํ•œ ์‹œ๋„๋“ค์ด ๋‚˜์˜ค๊ณ  ์žˆ์–ด:

Flow: ํŽ˜์ด์Šค๋ถ์ด ๋งŒ๋“  ํƒ€์ž… ์‹œ์Šคํ…œ์ด์ง€๋งŒ, ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์— ๋ฐ€๋ ค์„œ ์‚ฌ์šฉ๋ฅ ์ด ๋งŽ์ด ์ค„์—ˆ์–ด.

ReScript: OCaml ๊ธฐ๋ฐ˜์˜ ํƒ€์ž… ์•ˆ์ „ํ•œ ์–ธ์–ด๋กœ, ์ž๋ฐ”์Šคํฌ๋ฆฝํŠธ๋กœ ์ปดํŒŒ์ผ๋ผ. ํ•จ์ˆ˜ํ˜• ํ”„๋กœ๊ทธ๋ž˜๋ฐ ์ปค๋ฎค๋‹ˆํ‹ฐ์—์„œ ์ธ๊ธฐ๊ฐ€ ์žˆ์–ด.

Hegel: ๋” ๊ฐ•๋ ฅํ•œ ํƒ€์ž… ์‹œ์Šคํ…œ์„ ๋ชฉํ‘œ๋กœ ํ•˜๋Š” ํ”„๋กœ์ ํŠธ์•ผ.

ํ•˜์ง€๋งŒ ํ˜„์žฌ๋กœ์„œ๋Š” ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ์šฐ์œ„๊ฐ€ ํ™•๊ณ ํ•ด. ์ƒํƒœ๊ณ„, ์ปค๋ฎค๋‹ˆํ‹ฐ, ๋„๊ตฌ ์ง€์› ๋ฉด์—์„œ ์••๋„์ ์ด๊ฑฐ๋“ . ๐Ÿ‘‘

๐ŸŽฏ ๋งˆ๋ฌด๋ฆฌํ•˜๋ฉฐ

์™€, ์ •๋ง ๊ธด ์—ฌ์ •์ด์—ˆ์ง€? ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์— ๋Œ€ํ•ด ์ •๋ง ๋งŽ์€ ๊ฑธ ๋‹ค๋ค˜์–ด. ๐ŸŽ‰

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋Š” ๋‹จ์ˆœํžˆ ์ž๋ฐ”์Šคํฌ๋ฆฝํŠธ์— ํƒ€์ž…์„ ์ถ”๊ฐ€ํ•œ ๊ฒƒ ์ด์ƒ์ด์•ผ. ๋Œ€๊ทœ๋ชจ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์„ ์•ˆ์ „ํ•˜๊ฒŒ ๊ฐœ๋ฐœํ•  ์ˆ˜ ์žˆ๊ฒŒ ํ•ด์ฃผ๋Š” ๊ฐ•๋ ฅํ•œ ๋„๊ตฌ์ด์ž, ๊ฐœ๋ฐœ์ž์˜ ์ƒ์‚ฐ์„ฑ์„ ํฌ๊ฒŒ ํ–ฅ์ƒ์‹œ์ผœ์ฃผ๋Š” ํ”Œ๋žซํผ์ด์ง€.

ํ•ต์‹ฌ ํฌ์ธํŠธ ์ •๋ฆฌ:

1. ํƒ€์ž… ์•ˆ์ •์„ฑ: ์ปดํŒŒ์ผ ํƒ€์ž„์— ๋ฒ„๊ทธ๋ฅผ ์žก์•„๋‚ผ ์ˆ˜ ์žˆ์–ด
2. ๊ฐœ๋ฐœ ์ƒ์‚ฐ์„ฑ: IDE ์ง€์›์ด ๋›ฐ์–ด๋‚˜๊ณ  ๋ฆฌํŒฉํ† ๋ง์ด ์•ˆ์ „ํ•ด
3. ์ฝ”๋“œ ํ’ˆ์งˆ: ๋ช…์‹œ์ ์ธ ํƒ€์ž…์œผ๋กœ ์ฝ”๋“œ ์˜๋„๊ฐ€ ๋ช…ํ™•ํ•ด์ ธ
4. ํŒ€ ํ˜‘์—…: ํƒ€์ž…์ด ๋ฌธ์„œ ์—ญํ• ์„ ํ•ด์„œ ํ˜‘์—…์ด ์ˆ˜์›”ํ•ด
5. ์ƒํƒœ๊ณ„: ํ’๋ถ€ํ•œ ๋„๊ตฌ์™€ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์ง€์›

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋ฅผ ๋ฐฐ์šฐ๋Š” ๊ฑด ์ฒ˜์Œ์—๋Š” ์ข€ ์–ด๋ ค์šธ ์ˆ˜ ์žˆ์–ด. ์ž๋ฐ”์Šคํฌ๋ฆฝํŠธ์˜ ์ž์œ ๋กœ์›€์— ์ต์ˆ™ํ–ˆ๋‹ค๋ฉด ํƒ€์ž… ์‹œ์Šคํ…œ์ด ๋‹ต๋‹ตํ•˜๊ฒŒ ๋А๊ปด์งˆ ์ˆ˜๋„ ์žˆ์ง€. ํ•˜์ง€๋งŒ ์กฐ๊ธˆ๋งŒ ์ต์ˆ™ํ•ด์ง€๋ฉด, ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์—†์ด๋Š” ๊ฐœ๋ฐœํ•˜๊ธฐ ํž˜๋“ค์–ด์งˆ ๊ฑฐ์•ผ. ์ •๋ง์ด์•ผ! ๐Ÿ’ช

ํŠนํžˆ ๋Œ€๊ทœ๋ชจ ํ”„๋กœ์ ํŠธ๋‚˜ ํŒ€ ํ”„๋กœ์ ํŠธ์—์„œ๋Š” ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ์ง„๊ฐ€๊ฐ€ ๋ฐœํœ˜๋ผ. ์ฝ”๋“œ๋ฒ ์ด์Šค๊ฐ€ ์ปค์งˆ์ˆ˜๋ก, ํŒ€์›์ด ๋งŽ์•„์งˆ์ˆ˜๋ก, ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ์˜ ๊ฐ€์น˜๋Š” ๋”์šฑ ๋น›๋‚˜์ง€.

์•ž์œผ๋กœ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋Š” ๊ณ„์† ๋ฐœ์ „ํ•  ๊ฑฐ์•ผ. ๋” ๊ฐ•๋ ฅํ•œ ํƒ€์ž… ์‹œ์Šคํ…œ, ๋” ๋น ๋ฅธ ์ปดํŒŒ์ผ ์†๋„, ๋” ๋‚˜์€ ๊ฐœ๋ฐœ์ž ๊ฒฝํ—˜์„ ์ œ๊ณตํ•˜๋ฉด์„œ ๋ง์ด์ง€. ๊ทธ๋ฆฌ๊ณ  ์ž๋ฐ”์Šคํฌ๋ฆฝํŠธ ์ƒํƒœ๊ณ„์˜ ์‚ฌ์‹ค์ƒ ํ‘œ์ค€์œผ๋กœ ์ž๋ฆฌ์žก์„ ๊ฑฐ์•ผ.

์ด์ œ ์—ฌ๋Ÿฌ๋ถ„ ์ฐจ๋ก€์•ผ! ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋ฅผ ๋ฐฐ์šฐ๊ณ , ํ”„๋กœ์ ํŠธ์— ์ ์šฉํ•ด๋ณด๊ณ , ์ปค๋ฎค๋‹ˆํ‹ฐ์— ๊ธฐ์—ฌํ•ด๋ด. ๊ทธ๋ฆฌ๊ณ  ๋ง‰ํžˆ๋Š” ๋ถ€๋ถ„์ด ์žˆ๋‹ค๋ฉด ์ฃผ์ €ํ•˜์ง€ ๋ง๊ณ  ๋„์›€์„ ์š”์ฒญํ•ด. ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์ปค๋ฎค๋‹ˆํ‹ฐ๋Š” ์ •๋ง ์นœ์ ˆํ•˜๊ณ  ํ™œ๋ฐœํ•˜๊ฑฐ๋“ . ๐Ÿค

ํ–‰๋ณตํ•œ ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ ์ฝ”๋”ฉ ๋˜๊ธธ ๋ฐ”๋ผ! Happy TypeScripting! ๐Ÿš€โœจ

๐ŸŽ“ ๋” ๋ฐฐ์šฐ๊ณ  ์‹ถ๋‹ค๋ฉด?

ํƒ€์ž…์Šคํฌ๋ฆฝํŠธ๋ฅผ ๋” ๊นŠ์ด ๋ฐฐ์šฐ๊ณ  ์‹ถ๊ฑฐ๋‚˜, ์‹ค์ „ ํ”„๋กœ์ ํŠธ์— ์ ์šฉํ•˜๋Š” ๋ฐ ๋„์›€์ด ํ•„์š”ํ•˜๋‹ค๋ฉด
์žฌ๋Šฅ๋„ท์—์„œ ์ „๋ฌธ๊ฐ€๋“ค์˜ ๋ฉ˜ํ† ๋ง๊ณผ ๊ฐ•์˜๋ฅผ ๋ฐ›์•„๋ณด์„ธ์š”!
์‹ค๋ฌด ๊ฒฝํ—˜์ด ํ’๋ถ€ํ•œ ๊ฐœ๋ฐœ์ž๋“ค์ด ์—ฌ๋Ÿฌ๋ถ„์˜ ์„ฑ์žฅ์„ ๋„์™€๋“œ๋ฆฝ๋‹ˆ๋‹ค. ๐Ÿ’ช

๋Œ“๊ธ€ ์ž‘์„ฑ

์ด ๊ธ€์— ๋Œ€ํ•œ ์—ฌ๋Ÿฌ๋ถ„์˜ ์ƒ๊ฐ์„ ๋“ค๋ ค์ฃผ์„ธ์š”

๋Œ“๊ธ€ 0
๋Œ“๊ธ€์„ ๋ถˆ๋Ÿฌ์˜ค๋Š” ์ค‘์ž…๋‹ˆ๋‹ค.

์•„์ง ๋Œ“๊ธ€์ด ์—†์Šต๋‹ˆ๋‹ค.