์ด ํ์ด์ง์ ์ํ๋ AI ์ด์์คํดํธ๋ฅผ ์ฌ์ฉํ์ฌ ๋ฌธ์๋ฅผ ์์ฝํฉ๋๋ค
๋ฒ์ ๊ธฐ๋ก
- "๋ชจ๋ exports์ ๋ํ ํตํฉ ๋ฌธ์"v9.4.02026. 8. 24.
์ด ํ์ด์ง์ ์ฝํ ์ธ ๋ AI๋ฅผ ์ฌ์ฉํ์ฌ ๋ฒ์ญ๋์์ต๋๋ค.
์์ด ์๋ณธ ๋ด์ฉ์ ์ต์ ๋ฒ์ ์ ๋ณด๊ธฐ์ด ๋ฌธ์๋ฅผ ๊ฐ์ ํ ์์ด๋์ด๊ฐ ์์ผ์๋ฉด GitHub์ ํ ๋ฆฌํ์คํธ๋ฅผ ์ ์ถํ์ฌ ์์ ๋กญ๊ฒ ๊ธฐ์ฌํด ์ฃผ์ธ์.
๋ฌธ์์ ๋ํ GitHub ๋งํฌ๋ฌธ์์ Markdown์ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
elysia-intlayer ํจํค์ง
elysia-intlayer ํจํค์ง๋ Elysia ์ ํ๋ฆฌ์ผ์ด์
์์ ๊ตญ์ ํ๋ฅผ ์ฒ๋ฆฌํ๊ธฐ ์ํ ํ๋ฌ๊ทธ์ธ์ ์ ๊ณตํฉ๋๋ค. ์ฌ์ฉ์ ๋ก์ผ์ผ์ ๊ฐ์งํ๊ณ ๋ผ์ฐํธ ์ปจํ
์คํธ์ intlayer ๊ฐ์ฒด๋ฅผ ์ฃผ์
ํฉ๋๋ค.
์ค์น
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
elysia๋ peer dependency์ ๋๋ค (>=1.0.0). Elysia๋ Bun ๋ฐํ์์ ๋์์ผ๋ก ํฉ๋๋ค.
๋ด๋ณด๋ด๊ธฐ
ํ๋ฌ๊ทธ์ธ
์ํฌํธ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| ํจ์ | ์ค๋ช | ๊ด๋ จ ๋ฌธ์ |
|---|---|---|
intlayer | Intlayer๋ฅผ Elysia ์ ํ๋ฆฌ์ผ์ด์
์ ํตํฉํ๋ Elysia ํ๋ฌ๊ทธ์ธ. ์คํ ๋ฆฌ์ง(์ฟ ํค, ํค๋)์์, ์ด์ด์ Accept-Language์์ ๋ก์ผ์ผ ๊ฐ์ง๋ฅผ ์ฒ๋ฆฌํ๊ณ , locale, t, getIntlayer, getDictionary๋ฅผ ๋
ธ์ถํ๋ intlayer ๊ฐ์ฒด๋ฅผ ๋ผ์ฐํธ ์ปจํ
์คํธ์ ์ฃผ์
ํ๋ฉฐ, AsyncLocalStorage ์์ฒญ ์ปจํ
์คํธ๋ฅผ ์ค์ ํฉ๋๋ค. | intlayer |
ํจ์
์ํฌํธ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| ํจ์ | ์ค๋ช | ๊ด๋ จ ๋ฌธ์ |
|---|---|---|
t | Elysia์์ ํ์ฌ ๋ก์ผ์ผ์ ์ฝํ
์ธ ๋ฅผ ๊ฐ์ ธ์ค๋ ์ ์ญ ๋ฒ์ญ ํจ์. AsyncLocalStorage๋ฅผ ์ฌ์ฉํด intlayer ํ๋ฌ๊ทธ์ธ์ด ์ค์ ํ ์์ฒญ ์ปจํ
์คํธ์ ์ ๊ทผํ๋ฉฐ, ๊ทธ ์ธ๋ถ์์๋ ๊ธฐ๋ณธ ๋ก์ผ์ผ๋ก ํด๋ฐฑํฉ๋๋ค. intlayer.t๋ฅผ ํตํด์๋ ์ ๊ทผํ ์ ์์ต๋๋ค. | translation |
getIntlayer | ์์ฑ๋ ์ ์ธ์์ ํค๋ก ์ฌ์ ์ ๊ฐ์ ธ์ ํ์ฌ ๋ก์ผ์ผ์ ์ฝํ
์ธ ๋ฅผ ๋ฐํํฉ๋๋ค. getDictionary์ ์ต์ ํ ๋ฒ์ ์
๋๋ค. AsyncLocalStorage๋ฅผ ์ฌ์ฉํด ์์ฒญ ์ปจํ
์คํธ์ ์ ๊ทผํฉ๋๋ค. intlayer.getIntlayer๋ฅผ ํตํด์๋ ์ ๊ทผํ ์ ์์ต๋๋ค. | - |
getDictionary | ์ฌ์ ๊ฐ์ฒด๋ฅผ ์ฒ๋ฆฌํ์ฌ ํ์ฌ ๋ก์ผ์ผ์ ์ฝํ
์ธ ๋ฅผ ๋ฐํํฉ๋๋ค. t() ๋ฒ์ญ, ์ด๊ฑฐํ, markdown, HTML ๋ฑ์ ์ฒ๋ฆฌํฉ๋๋ค. AsyncLocalStorage๋ฅผ ์ฌ์ฉํด ์์ฒญ ์ปจํ
์คํธ์ ์ ๊ทผํฉ๋๋ค. intlayer.getDictionary๋ฅผ ํตํด์๋ ์ ๊ทผํ ์ ์์ต๋๋ค. | - |
ํ์
์ํฌํธ:
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ ์ด๋ธ์ ๋ชจ๋ฌ๋ก ์ด์ด ๋ชจ๋ ๋ฐ์ดํฐ๋ฅผ ๋ช ํํ๊ฒ ํ์ธ
| ํ์ | ์ค๋ช |
|---|---|
IntlayerContext | ๋ชจ๋ ๋ผ์ฐํธ ์ปจํ
์คํธ์ ์ฃผ์
๋๋ intlayer ๊ฐ์ฒด์ ํํ: locale, locale_storage, locale_detected, defaultLocale, t, getIntlayer, getDictionary. |
TranslateFunction | ๋ก์ผ์ผ ๋งต์ ํ์ฌ ์์ฒญ ๋ก์ผ์ผ์ ํด๋นํ๋ ์ฝํ ์ธ ๋ก ๋ณํํ๋ ๋ฒ์ญ ํจ์์ ์๊ทธ๋์ฒ. |
์ฌ์ฉ๋ฒ
์ฝ๋๋ฅผ ํด๋ฆฝ๋ณด๋์ ๋ณต์ฌ
ํ๋ฌ๊ทธ์ธ์ ์ ์ญderive๋ฅผ ํตํด ์ปจํ ์คํธ๋ฅผ ๋ฑ๋กํ๋ฉฐ, Elysia๋ ์ด๋ฅผPartial<{ intlayer: IntlayerContext }>๋ก ํ์ดํํฉ๋๋ค..use(intlayer())์ดํ์ ๋ฑ๋ก๋ ๋ผ์ฐํธ์์๋ ๋ฐํ์์ ๊ฐ์ด ํญ์ ์กด์ฌํ๋ฏ๋ก,strict๋ชจ๋์ TypeScript๋ฅผ ๋ง์กฑ์ํค๋ ค๋ฉด non-null ์ด์์ (intlayer!.locale) ๋๋ ์ต์ ๋ ์ฒด์ด๋์ ์ฌ์ฉํ์ธ์.
