copy original files

Author: uraway

docs/tsconfig/ja/options/disableReferencedProjectLoad.md

@@ -0,0 +1,8 @@
+---
+display: "disableReferencedProjectLoad"
+oneline: "Reduce the number of projects loaded automatically by TypeScript."
+---
+
+In multi-project TypeScript programs, TypeScript will load all of the available projects into memory in order to provide accurate results for editor responses which require a full knowledge graph like 'Find All References'.
+
+If your project is large, you can use the flag `disableReferencedProjectLoad` to disable the automatic loading of all projects. Instead, projects are loaded dynamically as you open files through your editor.

docs/tsconfig/ja/options/jsxFragmentFactory.md

@@ -0,0 +1,69 @@
+---
+display: "jsxFragmentFactory"
+oneline: "Specify the JSX Fragment reference used for fragments when targeting React JSX emit e.g. 'React.Fragment' or 'Fragment'."
+---
+
+Specify the JSX fragment factory function to use when targeting react JSX emit with `jsxFactory` compiler option is specified, e.g. `Fragment`.
+
+For example with this TSConfig:
+
+```json tsconfig
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "module": "commonjs",
+    "jsx": "react",
+    "jsxFactory": "h",
+    "jsxFragmentFactory": "Fragment"
+  }
+}
+```
+
+This TSX file:
+
+```tsx
+import { h, Fragment } from "preact";
+
+const HelloWorld = () => (
+  <>
+    <div>Hello</div>
+  </>
+);
+```
+
+Would look like:
+
+```tsx twoslash
+// @showEmit
+// @showEmittedFile: index.js
+// @jsxFactory: h
+// @jsxFragmentFactory: Fragment
+// @noErrors
+// @target: esnext
+// @module: commonjs
+
+import { h, Fragment } from "preact";
+
+const HelloWorld = () => (
+  <>
+    <div>Hello</div>
+  </>
+);
+```
+
+This option can be used on a per-file basis too similar to [Babel's `/* @jsxFrag h */` directive](https://babeljs.io/docs/en/babel-plugin-transform-react-jsx#fragments).
+
+For example:
+
+```tsx twoslash
+/** @jsx h */
+/** @jsxFrag Fragment */
+
+import { h, Fragment } from "preact";
+
+const HelloWorld = () => (
+  <>
+    <div>Hello</div>
+  </>
+);
+```

docs/tsconfig/ja/options/jsxImportSource.md

@@ -0,0 +1,95 @@
+---
+display: "jsxImportSource"
+oneline: "Specify module specifier used to import the JSX factory functions when using `jsx: react-jsx*`.`"
+---
+
+Declares the module specifier to be used for importing the `jsx` and `jsxs` factory functions when using [`jsx`](#jsx) as `"react-jsx"` or `"react-jsxdev"` which were introduced in TypeScript 4.1.
+
+With [React 17](https://reactjs.org/blog/2020/09/22/introducing-the-new-jsx-transform.html) the library supports a new form of JSX transformation via a separate import.
+
+For example with this code:
+
+```tsx
+import React from "react";
+
+function App() {
+  return <h1>Hello World</h1>;
+}
+```
+
+Using this TSConfig:
+
+```json tsconfig
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "module": "commonjs",
+    "jsx": "react-jsx"
+  }
+}
+```
+
+The emitted JavaScript from TypeScript is:
+
+```tsx twoslash
+// @showEmit
+// @noErrors
+// @jsx: react-jsx
+// @module: commonjs
+// @target: esnext
+declare module JSX {
+  interface Element {}
+  interface IntrinsicElements {
+    [s: string]: any;
+  }
+}
+import React from "react";
+
+function App() {
+  return <h1>Hello World</h1>;
+}
+```
+
+For example if you wanted to use `"jsxImportSource": "preact"`, you need a tsconfig like:
+
+```json tsconfig
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "module": "commonjs",
+    "jsx": "react-jsx",
+    "jsxImportSource": "preact",
+    "types": ["preact"]
+  }
+}
+```
+
+Which generates code like:
+
+```tsx twoslash
+// @showEmit
+// @jsxImportSource: preact
+// @types: preact
+// @jsx: react-jsx
+// @target: esnext
+// @module: commonjs
+// @noErrors
+
+export function App() {
+  return <h1>Hello World</h1>;
+}
+```
+
+Alternatively, you can use a per-file pragma to set this option, for example:
+
+```tsx
+/** @jsxImportSource preact */
+
+export function App() {
+  return <h1>Hello World</h1>;
+}
+```
+
+Would add `preact/jsx-runtime` as an import for the `_jsx` factory.
+
+_Note:_ In order for this to work like you would expect, your `tsx` file must include an `export` or `import` so that it is considered a module.

docs/tsconfig/ja/options/noUncheckedIndexedAccess.md

@@ -0,0 +1,53 @@
+---
+display: "noUncheckedIndexedAccess"
+oneline: "Add `undefined` to a type when accessed using an index."
+---
+
+TypeScript has a way to describe objects which have unknown keys but known values on an object, via index signatures.
+
+```ts twoslash
+interface EnvironmentVars {
+  NAME: string;
+  OS: string;
+
+  // Unknown properties are covered by this index signature.
+  [propName: string]: string;
+}
+
+declare const env: EnvironmentVars;
+
+// Declared as existing
+const sysName = env.NAME;
+const os = env.OS;
+//    ^?
+
+// Not declared, but because of the index
+// signature, then it is considered a string
+const nodeEnv = env.NODE_ENV;
+//    ^?
+```
+
+Turning on `noUncheckedIndexedAccess` will add `undefined` to any un-declared field in the type.
+
+```ts twoslash
+interface EnvironmentVars {
+  NAME: string;
+  OS: string;
+
+  // Unknown properties are covered by this index signature.
+  [propName: string]: string;
+}
+// @noUncheckedIndexedAccess
+// ---cut---
+declare const env: EnvironmentVars;
+
+// Declared as existing
+const sysName = env.NAME;
+const os = env.OS;
+//    ^?
+
+// Not declared, but because of the index
+// signature, then it is considered a string
+const nodeEnv = env.NODE_ENV;
+//    ^?
+```

docs/tsconfig/ja/options/watchDirectory.md

@@ -0,0 +1,10 @@
+---
+display: "watchDirectory"
+oneline: "Specify how directories are watched on systems that lack recursive file-watching functionality."
+---
+
+The strategy for how entire directory trees are watched under systems that lack recursive file-watching functionality.
+
+- `fixedPollingInterval`: Check every directory for changes several times a second at a fixed interval.
+- `dynamicPriorityPolling`: Use a dynamic queue where less-frequently modified directories will be checked less often.
+- `useFsEvents` (the default): Attempt to use the operating system/file system's native events for directory changes.

docs/tsconfig/ja/options/watchFile.md

@@ -0,0 +1,12 @@
+---
+display: "watchFile"
+oneline: "Specify how the TypeScript watch mode works."
+---
+
+The strategy for how individual files are watched.
+
+- `fixedPollingInterval`: Check every file for changes several times a second at a fixed interval.
+- `priorityPollingInterval`: Check every file for changes several times a second, but use heuristics to check certain types of files less frequently than others.
+- `dynamicPriorityPolling`: Use a dynamic queue where less-frequently modified files will be checked less often.
+- `useFsEvents` (the default): Attempt to use the operating system/file system's native events for file changes.
+- `useFsEventsOnParentDirectory`: Attempt to use the operating system/file system's native events to listen for changes on a file's parent directory

docs/tsconfig/ja/sections/compilerOptions.md

@@ -0,0 +1,3 @@
+### Compiler Options
+
+These options make up the bulk of TypeScript's configuration and it covers how the language should work.

docs/tsconfig/ja/sections/top_level.md

@@ -0,0 +1,3 @@
+### Root Fields
+
+Starting up are the root options in the TSConfig - these options relate to how your TypeScript or JavaScript project is set up.