API 参考 · 编辑领域

@oriatheme/editor-core

无 DOM、Storage 或框架依赖的草稿、字段元数据、智能阶梯、诊断、预览与提交会话。

包与运行环境

纯领域逻辑；只有 preview/save 方法接收由使用方创建的 Runtime。

bash

pnpm add @oriatheme/editor-core

bash

npm install @oriatheme/editor-core

bash

yarn add @oriatheme/editor-core

bash

bun add @oriatheme/editor-core

选择使用方项目已有的一种包管理器和 lockfile；示例只使用 package root export，不要从 src、dist 或 registry template 深层导入。

Exports

Export	Signature	Description
`describeTokenContract`	`(contract?) => readonly TokenFieldDescriptor[]`	Stable contract-order field metadata.
`describeToken`	`(path, contract?) => TokenFieldDescriptor \| undefined`	Looks up one editor field.
`getTokenModeScope`	`(path) => 'shared' \| 'mode'`	Returns standard-token editing scope.
`deriveSmartScale`	`(input: SmartScaleInput) => readonly DerivedTokenValue[]`	Expands a designer-facing master value.
`preserveScaleOverrides`	`(derived, current, customized) => readonly DerivedTokenValue[]`	Retains explicitly customized leaves.
`createThemeEditorIdentity`	`(source, existingThemes) => CloneIdentity`	Creates a stable unused identity for preset editing.
`createThemeEditorSession`	`(options) => ThemeEditorSession`	Creates the framework-independent draft session.

ThemeEditorSession

Export	Signature	Description
`getSnapshot / subscribe`	`() => ThemeEditorSnapshot / (listener) => unsubscribe`	Read or observe immutable editor state.
`setName / setToken / setTokens`	`(...) => void`	Change the draft by name, one token, or an atomic set.
`removeToken / resetToken / resetMode / resetAll`	`(...) => void`	Unset or restore draft values.
`replaceFromJson / exportJson`	`(json) => ImportResult / () => string`	Atomically import a draft or serialize it.
`preview`	`(runtime, mode?) => ThemeEditorPreviewResult`	Previews only complete valid revisions.
`save`	`(runtime) => ThemeEditorSaveResult`	Validates, creates/updates custom themes, or reports conflict.
`reload / destroy`	`(theme) => void / () => void`	Adopt an external version or release session resources.

重要类型与边界

ThemeEditorOptions 需要 source，编辑 preset 时需要 identity。ThemeEditorSaveResult 的失败原因是 validation 或 conflict；ThemeEditorPreviewResult 的失败返回 issues。不要在 React/Vue 或页面层复制草稿状态机。