599 lines
12 KiB
Markdown
599 lines
12 KiB
Markdown
# Interface: UserConfig
|
|
|
|
## Extends
|
|
|
|
- [`EditorConfig`](EditorConfig.md).[`FormatterConfig`](FormatterConfig.md)
|
|
|
|
## Extended by
|
|
|
|
- [`Config`](../../interfaces/Config.md)
|
|
|
|
## Properties
|
|
|
|
### appLanguage
|
|
|
|
> **appLanguage**: `undefined` \| [`AppLanguage`](../type-aliases/AppLanguage.md)
|
|
|
|
Sets the app UI language used.
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:707](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L707)
|
|
|
|
***
|
|
|
|
### autosave
|
|
|
|
> **autosave**: `boolean`
|
|
|
|
If `true`, the project is automatically saved on code change,
|
|
after time [delay](https://livecodes.io/docs/configuration/configuration-object#delay).
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
false
|
|
```
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:656](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L656)
|
|
|
|
***
|
|
|
|
### autotest
|
|
|
|
> **autotest**: `boolean`
|
|
|
|
If `true`, the project is watched for code changes which trigger tests to auto-run.
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
false
|
|
```
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:662](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L662)
|
|
|
|
***
|
|
|
|
### autoupdate
|
|
|
|
> **autoupdate**: `boolean`
|
|
|
|
If `true`, the result page is automatically updated on code change,
|
|
after time [delay](https://livecodes.io/docs/configuration/configuration-object#delay).
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
true
|
|
```
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:649](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L649)
|
|
|
|
***
|
|
|
|
### closeBrackets
|
|
|
|
> **closeBrackets**: `boolean`
|
|
|
|
Use auto-complete to close brackets and quotes.
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
true
|
|
```
|
|
|
|
#### Inherited from
|
|
|
|
[`EditorConfig`](EditorConfig.md).[`closeBrackets`](EditorConfig.md#closebrackets)
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:801](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L801)
|
|
|
|
***
|
|
|
|
### delay
|
|
|
|
> **delay**: `number`
|
|
|
|
Time delay (in milliseconds) following code change,
|
|
after which the result page is updated (if [`autoupdate`](https://livecodes.io/docs/configuration/configuration-object#autoupdate) is `true`)
|
|
and/or the project is saved (if [`autosave`](https://livecodes.io/docs/configuration/configuration-object#autosave) is `true`).
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
1500
|
|
```
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:670](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L670)
|
|
|
|
***
|
|
|
|
### editor
|
|
|
|
> **editor**: `undefined` \| `"auto"` \| `"monaco"` \| `"codemirror"` \| `"codejar"`
|
|
|
|
Selects the [code editor](https://livecodes.io/docs/features/editor-settings#code-editor) to use.
|
|
|
|
If `undefined` (the default), Monaco editor is used on desktop,
|
|
CodeMirror is used on mobile and in `simple` mode,
|
|
while CodeJar is used in `codeblock` mode, in `lite` mode and in `readonly` playgrounds.
|
|
|
|
If set to `auto`, Monaco editor is used on desktop and CodeMirror is used on mobile regardless of other settings.
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
undefined
|
|
```
|
|
|
|
#### Inherited from
|
|
|
|
[`EditorConfig`](EditorConfig.md).[`editor`](EditorConfig.md#editor)
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:722](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L722)
|
|
|
|
***
|
|
|
|
### editorMode
|
|
|
|
> **editorMode**: `undefined` \| `"vim"` \| `"emacs"`
|
|
|
|
Sets [editor mode](https://livecodes.io/docs/features/editor-settings#editor-modes).
|
|
|
|
#### Inherited from
|
|
|
|
[`EditorConfig`](EditorConfig.md).[`editorMode`](EditorConfig.md#editormode)
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:812](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L812)
|
|
|
|
***
|
|
|
|
### editorTheme
|
|
|
|
> **editorTheme**: `undefined` \| `string` \| [`EditorTheme`](../type-aliases/EditorTheme.md)[]
|
|
|
|
Sets the [code editor](https://livecodes.io/docs/features/editor-settings) themes.
|
|
|
|
See docs for [editor themes](https://livecodes.io/docs/configuration/configuration-object#editortheme) for details.
|
|
|
|
#### Examples
|
|
|
|
```ts
|
|
"vs"
|
|
```
|
|
|
|
```ts
|
|
"monaco:twilight, codemirror:one-dark"
|
|
```
|
|
|
|
```ts
|
|
["vs@light"]
|
|
```
|
|
|
|
```ts
|
|
["vs@light", "vs-dark@dark"]
|
|
```
|
|
|
|
```ts
|
|
["monaco:vs@light", "codemirror:github-light@light", "dracula@dark"]
|
|
```
|
|
|
|
#### Inherited from
|
|
|
|
[`EditorConfig`](EditorConfig.md).[`editorTheme`](EditorConfig.md#editortheme)
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:748](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L748)
|
|
|
|
***
|
|
|
|
### emmet
|
|
|
|
> **emmet**: `boolean`
|
|
|
|
Enables [Emmet](https://livecodes.io/docs/features/editor-settings#emmet).
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
true
|
|
```
|
|
|
|
#### Inherited from
|
|
|
|
[`EditorConfig`](EditorConfig.md).[`emmet`](EditorConfig.md#emmet)
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:807](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L807)
|
|
|
|
***
|
|
|
|
### enableAI
|
|
|
|
> **enableAI**: `boolean`
|
|
|
|
If `true`, [AI code assistant](https://livecodes.io/docs/features/ai) is enabled.
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
false
|
|
```
|
|
|
|
#### Inherited from
|
|
|
|
[`EditorConfig`](EditorConfig.md).[`enableAI`](EditorConfig.md#enableai)
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:818](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L818)
|
|
|
|
***
|
|
|
|
### foldRegions
|
|
|
|
> **foldRegions**: `boolean`
|
|
|
|
When set to `true`, regions marked by `#region` and `#endregion` comments are folded when the project is loaded.
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
false
|
|
```
|
|
|
|
#### Inherited from
|
|
|
|
[`EditorConfig`](EditorConfig.md).[`foldRegions`](EditorConfig.md#foldregions)
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:795](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L795)
|
|
|
|
***
|
|
|
|
### fontFamily
|
|
|
|
> **fontFamily**: `undefined` \| `string`
|
|
|
|
Sets the [code editor](https://livecodes.io/docs/features/editor-settings) font family.
|
|
|
|
#### Inherited from
|
|
|
|
[`EditorConfig`](EditorConfig.md).[`fontFamily`](EditorConfig.md#fontfamily)
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:753](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L753)
|
|
|
|
***
|
|
|
|
### fontSize
|
|
|
|
> **fontSize**: `undefined` \| `number`
|
|
|
|
Sets the font size.
|
|
|
|
If `undefined` (the default), the font size is set to 14 for the full app and 12 for [embeds](https://livecodes.io/docs/features/embeds).
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
undefined
|
|
```
|
|
|
|
#### Inherited from
|
|
|
|
[`EditorConfig`](EditorConfig.md).[`fontSize`](EditorConfig.md#fontsize)
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:761](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L761)
|
|
|
|
***
|
|
|
|
### formatOnsave
|
|
|
|
> **formatOnsave**: `boolean`
|
|
|
|
If `true`, the code is automatically [formatted](https://livecodes.io/docs/features/code-format) on saving the project.
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
false
|
|
```
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:676](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L676)
|
|
|
|
***
|
|
|
|
### layout
|
|
|
|
> **layout**: `undefined` \| `"horizontal"` \| `"vertical"` \| `"responsive"`
|
|
|
|
Sets the app layout to horizontal or vertical.
|
|
If set to `"responsive"` (the default) or `undefined`,
|
|
the layout is vertical in small screens when the playground height is larger than its width,
|
|
otherwise horizontal.
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
"responsive"
|
|
```
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:685](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L685)
|
|
|
|
***
|
|
|
|
### lineNumbers
|
|
|
|
> **lineNumbers**: `boolean` \| `"relative"`
|
|
|
|
Show line numbers in [code editor](https://livecodes.io/docs/features/editor-settings).
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
true
|
|
```
|
|
|
|
#### Inherited from
|
|
|
|
[`EditorConfig`](EditorConfig.md).[`lineNumbers`](EditorConfig.md#linenumbers)
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:783](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L783)
|
|
|
|
***
|
|
|
|
### recoverUnsaved
|
|
|
|
> **recoverUnsaved**: `boolean`
|
|
|
|
Enables [recovering last unsaved project](https://livecodes.io/docs/features/recover) when the app is reopened.
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
true
|
|
```
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:691](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L691)
|
|
|
|
***
|
|
|
|
### semicolons
|
|
|
|
> **semicolons**: `boolean`
|
|
|
|
Configures Prettier [code formatter](https://livecodes.io/docs/features/code-format) to use semi-colons.
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
true
|
|
```
|
|
|
|
#### Inherited from
|
|
|
|
[`FormatterConfig`](FormatterConfig.md).[`semicolons`](FormatterConfig.md#semicolons)
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:838](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L838)
|
|
|
|
***
|
|
|
|
### showSpacing
|
|
|
|
> **showSpacing**: `boolean`
|
|
|
|
Enables [showing element spacing](https://livecodes.io/docs/features/result#show-spacings) in the result page.
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
false
|
|
```
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:697](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L697)
|
|
|
|
***
|
|
|
|
### singleQuote
|
|
|
|
> **singleQuote**: `boolean`
|
|
|
|
Configures Prettier [code formatter](https://livecodes.io/docs/features/code-format) to use single quotes instead of double quotes.
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
false
|
|
```
|
|
|
|
#### Inherited from
|
|
|
|
[`FormatterConfig`](FormatterConfig.md).[`singleQuote`](FormatterConfig.md#singlequote)
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:843](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L843)
|
|
|
|
***
|
|
|
|
### tabSize
|
|
|
|
> **tabSize**: `number`
|
|
|
|
The number of spaces per indentation-level.
|
|
|
|
Also used in [code formatting](https://livecodes.io/docs/features/code-format).
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
2
|
|
```
|
|
|
|
#### Inherited from
|
|
|
|
[`FormatterConfig`](FormatterConfig.md).[`tabSize`](FormatterConfig.md#tabsize)
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:777](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L777)
|
|
|
|
***
|
|
|
|
### theme
|
|
|
|
> **theme**: [`Theme`](../type-aliases/Theme.md)
|
|
|
|
Sets the app [theme](https://livecodes.io/docs/features/themes) to light/dark mode.
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
"dark"
|
|
```
|
|
|
|
#### Inherited from
|
|
|
|
[`EditorConfig`](EditorConfig.md).[`theme`](EditorConfig.md#theme)
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:728](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L728)
|
|
|
|
***
|
|
|
|
### themeColor
|
|
|
|
> **themeColor**: `undefined` \| `string`
|
|
|
|
Sets the app theme color.
|
|
If `undefined`, it is set to `"hsl(214, 40%, 50%)"`.
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
undefined
|
|
```
|
|
|
|
#### Inherited from
|
|
|
|
[`EditorConfig`](EditorConfig.md).[`themeColor`](EditorConfig.md#themecolor)
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:735](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L735)
|
|
|
|
***
|
|
|
|
### trailingComma
|
|
|
|
> **trailingComma**: `boolean`
|
|
|
|
Configures Prettier [code formatter](https://livecodes.io/docs/features/code-format) to use [trailing commas](https://prettier.io/docs/en/options.html#trailing-commas).
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
true
|
|
```
|
|
|
|
#### Inherited from
|
|
|
|
[`FormatterConfig`](FormatterConfig.md).[`trailingComma`](FormatterConfig.md#trailingcomma)
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:849](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L849)
|
|
|
|
***
|
|
|
|
### useTabs
|
|
|
|
> **useTabs**: `boolean`
|
|
|
|
If `true`, lines are indented with tabs instead of spaces.
|
|
|
|
Also used in [code formatting](https://livecodes.io/docs/features/code-format).
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
false
|
|
```
|
|
|
|
#### Inherited from
|
|
|
|
[`FormatterConfig`](FormatterConfig.md).[`useTabs`](FormatterConfig.md#usetabs)
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:769](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L769)
|
|
|
|
***
|
|
|
|
### welcome
|
|
|
|
> **welcome**: `boolean`
|
|
|
|
If `true`, the [welcome screen](https://livecodes.io/docs/features/welcome) is displayed when the app loads.
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:702](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L702)
|
|
|
|
***
|
|
|
|
### wordWrap
|
|
|
|
> **wordWrap**: `boolean`
|
|
|
|
Enables word-wrap for long lines.
|
|
|
|
#### Default
|
|
|
|
```ts
|
|
false
|
|
```
|
|
|
|
#### Inherited from
|
|
|
|
[`EditorConfig`](EditorConfig.md).[`wordWrap`](EditorConfig.md#wordwrap)
|
|
|
|
#### Defined in
|
|
|
|
[models.ts:789](https://github.com/live-codes/livecodes/blob/7617d5c8be5a2a8be8133f973d9e69eb9f86434d/src/sdk/models.ts#L789) |