sapdon 3.0.3 → 3.1.0

package/dist/core/registry.js

@@ -8,6 +8,7 @@ export class GRegistry {
      * @param {string} data 实例 必须包含 toJson 方法
      */
     static register(name, root, path, data) {
+        console.log("client:",data)
         GRegistry.dataList.push({ name, root, path, data });
     }
     static getDataList() {

package/dist/oc/actor.js

@@ -0,0 +1,44 @@
+export class Actor {
+    target;
+    manager;
+    constructor(target, manager) {
+        this.target = target;
+        this.manager = manager;
+    }
+    static from(target, manager) {
+        return new Actor(target, manager);
+    }
+    /**
+     * 优先使用 `Actor.getComponent`
+     * @param ctors
+     * @returns
+     */
+    getMinecraftComponent(...ids) {
+        return ids.map(id => this.target.getComponent(id));
+    }
+    /**
+     * 优先使用 `Actor.getComponent`
+     * @param ctors
+     * @returns
+     */
+    getCustomComponent(...ctors) {
+        return this.manager.getComponents(...ctors);
+    }
+    getComponent(...descs) {
+        return descs.map(desc => {
+            if (typeof desc === 'string') {
+                return this.target.getComponent(desc);
+            }
+            return this.manager.getComponentUnsafe(desc);
+        });
+    }
+    addComponent(...components) {
+        return this.manager.attachComponent(...components);
+    }
+    removeComponent(ctor) {
+        return this.manager.detachComponent(ctor);
+    }
+    updateComponent(ctor, fn) {
+        return this.manager.update(ctor, fn);
+    }
+}

package/dist/oc/core.js

@@ -0,0 +1,201 @@
+import { system, world } from '@minecraft/server';
+import { Optional } from './optional.js';
+const REFLECT_MANAGER = Symbol('reflect-manager');
+const REFLECT_ENTITY = Symbol('reflect-entity');
+export class CustomComponent {
+    [REFLECT_MANAGER];
+    [REFLECT_ENTITY] = Optional.none();
+    onTick(manager, en) { }
+    detach(manager) {
+        const ctor = Object.getPrototypeOf(this).constructor;
+        return manager.detachComponent(ctor);
+    }
+    getManager() {
+        return this[REFLECT_MANAGER];
+    }
+    getEntity() {
+        return this[REFLECT_ENTITY];
+    }
+}
+export class BaseComponent extends CustomComponent {
+    onAttach(manager) { }
+    onDetach(manager) { }
+}
+export class ComponentManager {
+    static profilerEnable = false;
+    static global = new ComponentManager();
+    #components = new Map();
+    #prependTicks = [];
+    #nextTicks = [];
+    getComponentUnsafe(ctor) {
+        return this.#components.get(ctor);
+    }
+    getComponent(ctor) {
+        return Optional.some(this.#components.get(ctor));
+    }
+    getComponents(...ctor) {
+        return ctor.map(c => this.#components.get(c));
+    }
+    async #attachComponent(ctor, component, shouldRebuild = true) {
+        let init = !this.#components.get(ctor);
+        if (!init && shouldRebuild) {
+            await this.detachComponent(ctor);
+            init = true;
+        }
+        if (REQUIRED_COMPONENTS in component) {
+            //@ts-ignore
+            for (const [ctor, comp] of component[REQUIRED_COMPONENTS]) {
+                this.#attachComponent(ctor, comp, false);
+            }
+        }
+        if (init && 'onAttach' in component) {
+            await component.onAttach(this);
+        }
+        this.#components.set(ctor, component);
+        return Optional.some(component);
+    }
+    async attachComponent(...component) {
+        const components = [];
+        for (const obj of component) {
+            components.push(await this.#attachComponent(Object.getPrototypeOf(obj).constructor, obj));
+        }
+        return components;
+    }
+    async getOrCreate(ctor, ...args) {
+        let component = this.#components.get(ctor);
+        if (component) {
+            return Optional.some(component);
+        }
+        return this.#attachComponent(ctor, new ctor(...args));
+    }
+    async detachComponent(ctor) {
+        const component = this.#components.get(ctor);
+        if (component && 'onDetach' in component) {
+            await component.onDetach(this);
+        }
+        return this.#components.delete(ctor);
+    }
+    clear() {
+        this.#components.clear();
+    }
+    getComponentKeys() {
+        return this.#components.keys();
+    }
+    has(ctor) {
+        return this.#components.has(ctor);
+    }
+    afterTick(fn) {
+        this.#nextTicks.push(fn);
+    }
+    beforeTick(fn) {
+        this.#prependTicks.unshift(fn);
+    }
+    handleTicks(en) {
+        for (const prependTick of this.#prependTicks) {
+            this.profiler(() => prependTick.call(null, Optional.some(en)));
+            // prependTick.call(null, Optional.some(en))
+        }
+        this.#prependTicks.length = 0;
+        for (const component of this.#components.values()) {
+            //@ts-ignore
+            if (!component[REFLECT_ENTITY]) {
+                //@ts-ignore
+                component[REFLECT_ENTITY] = Optional.some(en);
+            }
+            //@ts-ignore
+            if (!component[REFLECT_MANAGER]) {
+                //@ts-ignore
+                component[REFLECT_MANAGER] = this;
+            }
+            const { onTick } = component;
+            if (onTick) {
+                this.profiler(() => onTick.call(component, this, Optional.some(en)), component);
+                // onTick.call(component, this, Optional.some(en))
+            }
+        }
+        for (const afterTick of this.#nextTicks) {
+            this.profiler(() => afterTick.call(null, Optional.some(en)));
+            // afterTick.call(null, Optional.some(en))
+        }
+        this.#nextTicks.length = 0;
+    }
+    update(ctor, fn) {
+        const component = this.#components.get(ctor);
+        if (component) {
+            fn(component);
+            return true;
+        }
+        return false;
+    }
+    profiler(fn, component, name) {
+        if (!ComponentManager.profilerEnable) {
+            return fn();
+        }
+        const conponentName = component ? Object.getPrototypeOf(component).constructor.name : '';
+        const profileName = name ? name
+            : conponentName ? (`${conponentName}.${fn.name}`)
+                : fn.name;
+        const now = performance.now();
+        const val = fn();
+        console.log(`[Profiler] ${profileName} took ${performance.now() - now}ms`);
+        return val;
+    }
+}
+const REQUIRED_COMPONENTS = Symbol('REQUIRED_COMPONENTS');
+export function RequireComponents(...params) {
+    return class CRequiredComponent extends BaseComponent {
+        [REQUIRED_COMPONENTS] = new Map();
+        constructor() {
+            super();
+            for (const param of params) {
+                if (Array.isArray(param)) {
+                    const [Ctor, ...args] = param;
+                    this[REQUIRED_COMPONENTS].set(Ctor, Reflect.construct(Ctor, args));
+                    continue;
+                }
+                this[REQUIRED_COMPONENTS].set(param, Reflect.construct(param, []));
+            }
+        }
+        getComponent(ctor) {
+            return this[REQUIRED_COMPONENTS].get(ctor);
+        }
+    };
+}
+export var oc;
+(function (oc) {
+    const table = new Map();
+    function addEntity(entityId) {
+        const manager = new ComponentManager();
+        table.set(entityId, manager);
+        return manager;
+    }
+    oc.addEntity = addEntity;
+    function removeEntity(entityId) {
+        const uid = entityId;
+        const manager = table.get(uid);
+        manager?.clear();
+        table.delete(uid);
+    }
+    oc.removeEntity = removeEntity;
+    function getManager(entityId) {
+        return table.get(entityId) ?? addEntity(entityId);
+    }
+    oc.getManager = getManager;
+    function tick() {
+        for (const [id, manager] of table.entries()) {
+            const entity = world.getEntity(id);
+            if (entity) {
+                manager.handleTicks(entity);
+            }
+        }
+    }
+    oc.tick = tick;
+    function start() {
+        system.runInterval(tick);
+    }
+    oc.start = start;
+    function toPlayer(entity) {
+        return Optional.some(world.getAllPlayers().find(p => p.id === entity.id));
+    }
+    oc.toPlayer = toPlayer;
+})(oc || (oc = {}));

package/dist/oc/index.d.ts

@@ -4,7 +4,7 @@ import { Entity, Player, InputButton } from '@minecraft/server';
 declare class Optional<T = any> {
     private value;
     static none<T>(): Optional<T>;
-    static some<T>(value: T): Optional<T>;
+    static some<T>(value?: T): Optional<T>;
     constructor(value: T);
     unwrap(): T;
     isEmpty(): boolean;
@@ -90,8 +90,8 @@ type ComponentDescriptor = string | ComponentCtor;
 declare class Actor {
     readonly target: Entity;
     readonly manager: ComponentManager;
-    constructor(target: Entity, manager: ComponentManager);
-    static from(target: Entity, manager: ComponentManager): Actor;
+    constructor(target: Entity);
+    static from(target: Entity): Actor;
     /**
      * 优先使用 `Actor.getComponent`
      * @param ctors

package/dist/oc/index.js

@@ -1 +1 @@
-import{world as t,system as e,InputButton as n,ButtonState as s}from"@minecraft/server";class o{target;manager;constructor(t,e){this.target=t,this.manager=e}static from(t,e){return new o(t,e)}getMinecraftComponent(...t){return t.map((t=>this.target.getComponent(t)))}getCustomComponent(...t){return this.manager.getComponents(...t)}getComponent(...t){return t.map((t=>"string"==typeof t?this.target.getComponent(t):this.manager.getComponentUnsafe(t)))}addComponent(...t){return this.manager.attachComponent(...t)}removeComponent(t){return this.manager.detachComponent(t)}updateComponent(t,e){return this.manager.update(t,e)}}class r{value;static none(){return new r(null)}static some(t){return new r(t)}constructor(t){this.value=t}unwrap(){if(!this.isEmpty())return this.value;throw new Error("Optional is empty")}isEmpty(){return void 0===this.value||null===this.value}orElse(t){return this.value??t}use(t,e){return!this.isEmpty()&&(t.call(e,this.value),!0)}}const a=Symbol("reflect-manager"),i=Symbol("reflect-entity");class c{[a];[i]=r.none();onTick(t,e){}detach(t){const e=Object.getPrototypeOf(this).constructor;return t.detachComponent(e)}getManager(){return this[a]}getEntity(){return this[i]}}class p extends c{onAttach(t){}onDetach(t){}}class u{static profilerEnable=!1;static global=new u;#t=new Map;#e=[];#n=[];getComponentUnsafe(t){return this.#t.get(t)}getComponent(t){return r.some(this.#t.get(t))}getComponents(...t){return t.map((t=>this.#t.get(t)))}async#s(t,e,n=!0){let s=!this.#t.get(t);if(!s&&n&&(await this.detachComponent(t),s=!0),l in e)for(const[t,n]of e[l])this.#s(t,n,!1);return s&&"onAttach"in e&&await e.onAttach(this),this.#t.set(t,e),r.some(e)}async attachComponent(...t){const e=[];for(const n of t)e.push(await this.#s(Object.getPrototypeOf(n).constructor,n));return e}async getOrCreate(t,...e){let n=this.#t.get(t);return n?r.some(n):this.#s(t,new t(...e))}async detachComponent(t){const e=this.#t.get(t);return e&&"onDetach"in e&&await e.onDetach(this),this.#t.delete(t)}clear(){this.#t.clear()}getComponentKeys(){return this.#t.keys()}has(t){return this.#t.has(t)}afterTick(t){this.#n.push(t)}beforeTick(t){this.#e.unshift(t)}handleTicks(t){for(const e of this.#e)this.profiler((()=>e.call(null,r.some(t))));this.#e.length=0;for(const e of this.#t.values()){e[i]||(e[i]=r.some(t)),e[a]||(e[a]=this);const{onTick:n}=e;n&&this.profiler((()=>n.call(e,this,r.some(t))),e)}for(const e of this.#n)this.profiler((()=>e.call(null,r.some(t))));this.#n.length=0}update(t,e){const n=this.#t.get(t);return!!n&&(e(n),!0)}profiler(t,e,n){if(!u.profilerEnable)return t();const s=e?Object.getPrototypeOf(e).constructor.name:"",o=n||(s?`${s}.${t.name}`:t.name),r=performance.now(),a=t();return console.log(`[Profiler] ${o} took ${performance.now()-r}ms`),a}}const l=Symbol("REQUIRED_COMPONENTS");function h(...t){return class extends p{[l]=new Map;constructor(){super();for(const e of t)if(Array.isArray(e)){const[t,...n]=e;this[l].set(t,Reflect.construct(t,n))}else this[l].set(e,Reflect.construct(e,[]))}getComponent(t){return this[l].get(t)}}}var m,f;!function(n){const s=new Map;function o(t){const e=new u;return s.set(t,e),e}function a(){for(const[e,n]of s.entries()){const s=t.getEntity(e);s&&n.handleTicks(s)}}n.addEntity=o,n.removeEntity=function(t){const e=t,n=s.get(e);n?.clear(),s.delete(e)},n.getManager=function(t){return s.get(t)??o(t)},n.tick=a,n.start=function(){e.runInterval(a)},n.toPlayer=function(e){return r.some(t.getAllPlayers().find((t=>t.id===e.id)))}}(m||(m={})),function(t){t[t.Press=0]="Press",t[t.Release=1]="Release",t[t.None=2]="None"}(f||(f={}));class g extends p{[n.Jump]=f.None;[n.Sneak]=f.None;static setup(){t.afterEvents.playerButtonInput.subscribe((t=>{const e=m.getManager(t.player.id);e.getComponent(g).use((n=>{n[t.button]=t.newButtonState===s.Pressed?f.Press:f.Release,e.afterTick((()=>{n[t.button]=f.None}))}))}))}}class d extends p{[n.Jump]=f.None;[n.Sneak]=f.None;_lastJump=s.Released;_lastSneak=s.Released;onTick(t,e){const o=m.toPlayer(e.unwrap()).unwrap(),r=o.inputInfo.getButtonState(n.Jump),a=o.inputInfo.getButtonState(n.Sneak);r===s.Pressed&&this._lastJump===s.Released?this[n.Jump]=f.Press:r===s.Released&&this._lastJump===s.Pressed?this[n.Jump]=f.Release:this[n.Jump]=f.None,a===s.Pressed&&this._lastSneak===s.Released?this[n.Sneak]=f.Press:a===s.Released&&this._lastSneak===s.Pressed?this[n.Sneak]=f.Release:this[n.Sneak]=f.None,this._lastJump=r,this._lastSneak=a}}export{o as Actor,p as BaseComponent,u as ComponentManager,c as CustomComponent,f as InputChangeState,r as Optional,d as PlayerInputCompatibilityComponent,g as PlayerInputComponent,h as RequireComponents,m as oc};
+import{world as t,system as e,InputButton as n,ButtonState as s}from"@minecraft/server";class o{value;static none(){return new o(null)}static some(t){return new o(t)}constructor(t){this.value=t}unwrap(){if(!this.isEmpty())return this.value;throw new Error("Optional is empty")}isEmpty(){return void 0===this.value||null===this.value}orElse(t){return this.value??t}use(t,e){return!this.isEmpty()&&(t.call(e,this.value),!0)}}const r=Symbol("reflect-manager"),a=Symbol("reflect-entity");class i{[r];[a]=o.none();onTick(t,e){}detach(t){const e=Object.getPrototypeOf(this).constructor;return t.detachComponent(e)}getManager(){return this[r]}getEntity(){return this[a]}}class c extends i{onAttach(t){}onDetach(t){}}class p{static profilerEnable=!1;static global=new p;#t=new Map;#e=[];#n=[];getComponentUnsafe(t){return this.#t.get(t)}getComponent(t){return o.some(this.#t.get(t))}getComponents(...t){return t.map((t=>this.#t.get(t)))}async#s(t,e,n=!0){let s=!this.#t.get(t);if(!s&&n&&(await this.detachComponent(t),s=!0),u in e)for(const[t,n]of e[u])this.#s(t,n,!1);return s&&"onAttach"in e&&await e.onAttach(this),this.#t.set(t,e),o.some(e)}async attachComponent(...t){const e=[];for(const n of t)e.push(await this.#s(Object.getPrototypeOf(n).constructor,n));return e}async getOrCreate(t,...e){let n=this.#t.get(t);return n?o.some(n):this.#s(t,new t(...e))}async detachComponent(t){const e=this.#t.get(t);return e&&"onDetach"in e&&await e.onDetach(this),this.#t.delete(t)}clear(){this.#t.clear()}getComponentKeys(){return this.#t.keys()}has(t){return this.#t.has(t)}afterTick(t){this.#n.push(t)}beforeTick(t){this.#e.unshift(t)}handleTicks(t){for(const e of this.#e)this.profiler((()=>e.call(null,o.some(t))));this.#e.length=0;for(const e of this.#t.values()){e[a]||(e[a]=o.some(t)),e[r]||(e[r]=this);const{onTick:n}=e;n&&this.profiler((()=>n.call(e,this,o.some(t))),e)}for(const e of this.#n)this.profiler((()=>e.call(null,o.some(t))));this.#n.length=0}update(t,e){const n=this.#t.get(t);return!!n&&(e(n),!0)}profiler(t,e,n){if(!p.profilerEnable)return t();const s=e?Object.getPrototypeOf(e).constructor.name:"",o=n||(s?`${s}.${t.name}`:t.name),r=performance.now(),a=t();return console.log(`[Profiler] ${o} took ${performance.now()-r}ms`),a}}const u=Symbol("REQUIRED_COMPONENTS");function l(...t){return class extends c{[u]=new Map;constructor(){super();for(const e of t)if(Array.isArray(e)){const[t,...n]=e;this[u].set(t,Reflect.construct(t,n))}else this[u].set(e,Reflect.construct(e,[]))}getComponent(t){return this[u].get(t)}}}var h,m;!function(n){const s=new Map;function r(t){const e=new p;return s.set(t,e),e}function a(){for(const[e,n]of s.entries()){const s=t.getEntity(e);s&&n.handleTicks(s)}}n.addEntity=r,n.removeEntity=function(t){const e=t,n=s.get(e);n?.clear(),s.delete(e)},n.getManager=function(t){return s.get(t)??r(t)},n.tick=a,n.start=function(){e.runInterval(a)},n.toPlayer=function(e){return o.some(t.getAllPlayers().find((t=>t.id===e.id)))}}(h||(h={}));class f{target;manager;constructor(t){this.target=t,this.manager=h.getManager(t.id)}static from(t){return new f(t)}getMinecraftComponent(...t){return t.map((t=>this.target.getComponent(t)))}getCustomComponent(...t){return this.manager.getComponents(...t)}getComponent(...t){return t.map((t=>"string"==typeof t?this.target.getComponent(t):this.manager.getComponentUnsafe(t)))}addComponent(...t){return this.manager.attachComponent(...t)}removeComponent(t){return this.manager.detachComponent(t)}updateComponent(t,e){return this.manager.update(t,e)}}!function(t){t[t.Press=0]="Press",t[t.Release=1]="Release",t[t.None=2]="None"}(m||(m={}));class g extends c{[n.Jump]=m.None;[n.Sneak]=m.None;static setup(){t.afterEvents.playerButtonInput.subscribe((t=>{const e=h.getManager(t.player.id);e.getComponent(g).use((n=>{n[t.button]=t.newButtonState===s.Pressed?m.Press:m.Release,e.afterTick((()=>{n[t.button]=m.None}))}))}))}}class d extends c{[n.Jump]=m.None;[n.Sneak]=m.None;_lastJump=s.Released;_lastSneak=s.Released;onTick(t,e){const o=h.toPlayer(e.unwrap()).unwrap(),r=o.inputInfo.getButtonState(n.Jump),a=o.inputInfo.getButtonState(n.Sneak);r===s.Pressed&&this._lastJump===s.Released?this[n.Jump]=m.Press:r===s.Released&&this._lastJump===s.Pressed?this[n.Jump]=m.Release:this[n.Jump]=m.None,a===s.Pressed&&this._lastSneak===s.Released?this[n.Sneak]=m.Press:a===s.Released&&this._lastSneak===s.Pressed?this[n.Sneak]=m.Release:this[n.Sneak]=m.None,this._lastJump=r,this._lastSneak=a}}export{f as Actor,c as BaseComponent,p as ComponentManager,i as CustomComponent,m as InputChangeState,o as Optional,d as PlayerInputCompatibilityComponent,g as PlayerInputComponent,l as RequireComponents,h as oc};

package/dist/oc/input.js

@@ -0,0 +1,67 @@
+import { ButtonState, InputButton, world } from "@minecraft/server";
+import { BaseComponent } from "./core.js";
+import { oc } from './core.js';
+export var InputChangeState;
+(function (InputChangeState) {
+    InputChangeState[InputChangeState["Press"] = 0] = "Press";
+    InputChangeState[InputChangeState["Release"] = 1] = "Release";
+    InputChangeState[InputChangeState["None"] = 2] = "None";
+})(InputChangeState || (InputChangeState = {}));
+/**
+ * `@minecraft/server` version 2.0.0-beta
+ * 低于此版本请不要使用此组件
+ */
+export class PlayerInputComponent extends BaseComponent {
+    ;
+    [InputButton.Jump] = InputChangeState.None;
+    [InputButton.Sneak] = InputChangeState.None;
+    static setup() {
+        world.afterEvents.playerButtonInput.subscribe(e => {
+            const manager = oc.getManager(e.player.id);
+            const playerInput = manager.getComponent(PlayerInputComponent);
+            playerInput.use(playerInput => {
+                playerInput[e.button] = e.newButtonState === ButtonState.Pressed ? InputChangeState.Press : InputChangeState.Release;
+                manager.afterTick(() => {
+                    playerInput[e.button] = InputChangeState.None;
+                });
+            });
+        });
+    }
+}
+/**
+ * `@minecraft/server` version 1.17.0-beta
+ * 有 1tick 延迟
+ * 条件允许请使用 `PlayerInputComponent`
+ */
+export class PlayerInputCompatibilityComponent extends BaseComponent {
+    ;
+    [InputButton.Jump] = InputChangeState.None;
+    [InputButton.Sneak] = InputChangeState.None;
+    _lastJump = ButtonState.Released;
+    _lastSneak = ButtonState.Released;
+    onTick(manager, en) {
+        const player = oc.toPlayer(en.unwrap()).unwrap();
+        const jump = player.inputInfo.getButtonState(InputButton.Jump);
+        const sneak = player.inputInfo.getButtonState(InputButton.Sneak);
+        if (jump === ButtonState.Pressed && this._lastJump === ButtonState.Released) {
+            this[InputButton.Jump] = InputChangeState.Press;
+        }
+        else if (jump === ButtonState.Released && this._lastJump === ButtonState.Pressed) {
+            this[InputButton.Jump] = InputChangeState.Release;
+        }
+        else {
+            this[InputButton.Jump] = InputChangeState.None;
+        }
+        if (sneak === ButtonState.Pressed && this._lastSneak === ButtonState.Released) {
+            this[InputButton.Sneak] = InputChangeState.Press;
+        }
+        else if (sneak === ButtonState.Released && this._lastSneak === ButtonState.Pressed) {
+            this[InputButton.Sneak] = InputChangeState.Release;
+        }
+        else {
+            this[InputButton.Sneak] = InputChangeState.None;
+        }
+        this._lastJump = jump;
+        this._lastSneak = sneak;
+    }
+}

package/dist/oc/optional.js

@@ -0,0 +1,31 @@
+export class Optional {
+    value;
+    static none() {
+        return new Optional(null);
+    }
+    static some(value) {
+        return new Optional(value);
+    }
+    constructor(value) {
+        this.value = value;
+    }
+    unwrap() {
+        if (!this.isEmpty()) {
+            return this.value;
+        }
+        throw new Error('Optional is empty');
+    }
+    isEmpty() {
+        return this.value === undefined || this.value === null;
+    }
+    orElse(other) {
+        return this.value ?? other;
+    }
+    use(fn, self) {
+        if (!this.isEmpty()) {
+            fn.call(self, this.value);
+            return true;
+        }
+        return false;
+    }
+}

package/doc/sapdon-ts.md

@@ -18,11 +18,10 @@ import { ItemAPI } from '@sapdon/core'
 ## 从js迁移到ts
 js 的 `main.mjs` 包含了一些预定义的代码：
 ```js
-import { startDevServer } from '@sapdon/cli'
-import { GRegistry, UISystemRegistry } from '@sapdon/core'
+import { registry } from '@sapdon/core'
 
-// 开启开发服务器, 不开启开发服务器无法使用文件同步和热更新
-startDevServer(GRegistry, UISystemRegistry)
+// 进行注册后需进行一次提交, 通知开发服务器更新文件
+registry.setup()
 ```
 如果需要从js迁移到ts，删除 `startDevServer` 那行即可（不删也没事）
 
@@ -59,4 +58,7 @@ manager.attachComponent(new MyComponent())
 
 你也可以动态增删改查组件! 这很方便!
 
-如果你想看它到底是怎么回事,可以从 `examples/oc-core` 开始了解
+如果你想看它到底是怎么回事,可以从 `examples/oc-core` 开始了解
+
+## [Object - Component](./oc/index.md)
+关于 `@sapdon/oc` 的一切

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "sapdon",
-    "version": "3.0.3",
+    "version": "3.1.0",
     "scripts": {
         "build": "rollup -c",
         "pub": "rollup -c && npm publish"

package/doc/cli.md

@@ -1,24 +0,0 @@
-# `@sapdon/cli` 包
-
-## 自定义处理器
-```ts
-import { devServer } from '@sapdon/cli'
-devServer.handle('ping', () => {
-    console.log('pong')
-})
-```
-
-## 拦截cli处理器
-```ts
-import { devServer, ServerHandles } from '@sapdon/cli'
-
-devServer.interceptHandler(ServerHandles.WRITE_ADDON, handler => {
-    return (...args: any[]) => {
-        const now = peformance.now()
-        handler.apply(args)
-        const dt = peformance.now() - now
-        console.log(`执行耗时 ${dt}ms.`)
-    }
-})
-```
-