From a044ed3356b33a8f7743715a496b5ab9d173ecee Mon Sep 17 00:00:00 2001
From: "juncheng.du" <juncheng.du@beibei.com>
Date: Sun, 28 Jul 2019 21:54:23 +0800
Subject: [PATCH 1/2] add run time

---
 runtime/Client-side component API.md | 111 +++++++++++++++++++++++++++
 runtime/Custom element API.md        |   2 +
 runtime/Server-side component API.md |  18 +++++
 3 files changed, 131 insertions(+)
 create mode 100644 runtime/Client-side component API.md
 create mode 100644 runtime/Custom element API.md
 create mode 100644 runtime/Server-side component API.md

diff --git a/runtime/Client-side component API.md b/runtime/Client-side component API.md
new file mode 100644
index 0000000..fdefd07
--- /dev/null
+++ b/runtime/Client-side component API.md	
@@ -0,0 +1,111 @@
+### Creating a component
+
+```javascript
+const component = new Component(options)
+```
+
+**客户端组件** （ client-side component ）是使用`generate：'dom'` 参数编译的组件（或未指定的generate选项），其是一个JavaScript类。
+
+```javascript
+import App from './App.svelte';
+
+const app = new App({
+	target: document.body,
+	props: {
+		// assuming App.svelte contains something like
+		// `export let answer`:
+		answer: 42
+	}
+});
+```
+
+可以提供以下初始化选项：
+
+| option    | default  | description                                                 |
+| :-------- | :------- | :---------------------------------------------------------- |
+| `target`  | **none** | 必传。组件挂载的一个`HTMLElement` 对象。                    |
+| `anchor`  | `null`   | `target` 的一个子节点，我们的组件将会被插入到该节点的前面。 |
+| `props`   | `{}`     | 要提供给组件的属性对象                                      |
+| `hydrate` | `false`  | 见下方                                                      |
+| `intro`   | `false`  | 如果为true，将在初始渲染时转换，而不是等待后续状态更改      |
+
+`target` 节点中，那些已经存在的子节点，将会保持其原有的位置。
+
+`hydrate`选项会让`Svelte `更新现有DOM（通常来自服务器端渲染）而不是创建新元素。它只有在使用`hydratable：true`选项编译组件时才有效。
+
+尽管上面提到，`target` 节点中，那些已经存在的子节点，将会保持其原有的位置。但是 `hydratable：true`选项会让所有的子节点都被删除，所以 `anchor` 的选项不能和 `hydrate: true` 一起使用。
+
+现存的DOM节点不必匹配上组件，因为 svelted会修复DOM节点。
+
+```javascript
+import App from './App.svelte';
+
+const app = new App({
+	target: document.querySelector('#server-rendered-html'),
+	hydrate: true
+});
+```
+
+
+
+### `$set`
+
+```javascript
+component.$set(props)
+```
+
+显式的在实例上设置 `props`。 在` <script> ` 标签内，`component.$set({ x: 1 })` 和 `x = 1` 的两个写法作用一致。
+
+调用此方法会在下一个微任务调度更新，这是因为 DOM不会同步更新。
+
+```javascript
+component.$set({ answer: 42 });
+```
+
+### `$on`
+
+```javascript
+component.$on(event, callback)
+```
+
+每当组件派发事件时，都会调用对应的回调函数。
+
+该方法返回一个函数，该函数将在调用时删除事件侦听器。
+
+```javascript
+const off = app.$on('selected', event => {
+	console.log(event.detail.selection);
+});
+
+off();
+```
+
+### `$destroy`
+
+```javascript
+component.$destroy()
+```
+
+从DOM中删除组件, 并触发任何`onDestroy` 回调函数。
+
+### Component props
+
+```
+component.prop
+```
+
+```javascript
+component.prop = value
+```
+
+如果组件使用` accessors: true ` 编译，则每个实例都将具有与组件的`props`相对应的`getter`和`setter`。
+
+手动设置值将导致`同步`更新，而`component.$set（...）` 方法默认是异步更新。
+
+ 默认情况下，`accessors`为false，除非您将其编译为自定义元素。
+
+```javascript
+console.log(app.count);
+app.count += 1;
+```
+
diff --git a/runtime/Custom element API.md b/runtime/Custom element API.md
new file mode 100644
index 0000000..d4b7cd8
--- /dev/null
+++ b/runtime/Custom element API.md	
@@ -0,0 +1,2 @@
+- TODO  ( 官网是 todo的状态，如果官网更新，我们会第一时间更新的 )
+
diff --git a/runtime/Server-side component API.md b/runtime/Server-side component API.md
new file mode 100644
index 0000000..dda76e5
--- /dev/null
+++ b/runtime/Server-side component API.md	
@@ -0,0 +1,18 @@
+```javascript
+const result = Component.render(...)
+```
+
+与客户端组件不同，服务器端组件在渲染后没有生命周期 。他们的全部工作是创建一些HTML和CSS。出于这个原因，API有些不同。
+
+服务器端组件暴露了一个`render`方法，该`render` 方法接收可选的`props`, 同时该 `render` 方法返回一个带有`head`，`html`和`css`属性的对象，其中head包含遇到的任何<svelte：head>元素的内容。
+
+```javascript
+const App = require('./App.svelte');
+
+const { head, html, css } = App.render({
+	answer: 42
+});
+```
+
+
+

From 4ba6124541704cea4e9169566428f00bb1cfb0fc Mon Sep 17 00:00:00 2001
From: "juncheng.du" <juncheng.du@beibei.com>
Date: Sun, 28 Jul 2019 22:01:09 +0800
Subject: [PATCH 2/2] add

---
 SUMMARY.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/SUMMARY.md b/SUMMARY.md
index 580cdc6..70c606e 100644
--- a/SUMMARY.md
+++ b/SUMMARY.md
@@ -38,9 +38,13 @@
   * [svelte:options](chapter2/svelte-options.md)
   * [@debug](chapter2/debug.md)
 * [运行时](runtime/README.md)
+  * [Client-side component API](runtime/Client-side component API.md)
+  * [Custom element API](runtime/Custom element API.md)
+  * [Server-side component API](runtime/Server-side component API.md)
 * [编译时](api-compile-time/README.md)
   * [svelte.compile](api-compile-time/svelte.compile.md)
   * [svelte.parse](api-compile-time/svelte.parse.md)
   * [svelte.preprocess](api-compile-time/svelte.preprocess.md)
   * [svelte.walk](api-compile-time/svelte.walk.md)
   * [svelte.VERSION](api-compile-time/svelte.VERSION.md)
+