dsh-memo-ilife 0.2.1 → 0.3.1

package/dist/client.js

@@ -71,29 +71,30 @@ window.__ModuleLoader__.load({
 				key: "db.dir",
 				title: "数据目录",
 				tier: "common",
-				control: "text",
-				hint: "库文件与产物的根目录。留空＝按默认落点（配置目录下的 data/），也就是改造前那个位置。"
+				control: "directory",
+				prefillFrom: "dataDir",
+				hint: "库文件与产物的根目录。留空＝用默认目录。"
 			},
 			{
 				key: "db.name",
 				title: "库文件名",
 				tier: "common",
 				control: "text",
-				hint: "数据目录下的数据库文件名。留空＝按默认落点（memo.db）；改它等于换一个备忘录库，老笔记留在旧文件里不会跟过来。"
+				hint: "数据目录下的数据库文件名（默认 memo.db）。改名＝换库，旧笔记不会被读入。"
 			},
 			{
 				key: "html.dir",
 				title: "HTML 产物目录名",
 				tier: "common",
 				control: "text",
-				hint: "数据目录下放 HELP 页面的子目录名，只有一段。留空＝按默认落点（memo_html）；改它之后新产物落新地方，旧的留在原处。"
+				hint: "数据目录下存放 HELP 页面的子目录名（默认 memo_html）。"
 			},
 			{
 				key: "media.dir",
 				title: "附件目录",
 				tier: "common",
-				control: "text",
-				hint: "附件的根目录：技能会把它解析成绝对路径并要求目录真的在（附件路径按真包含判定）。留空＝按默认落点（相对进程工作目录的 media）。"
+				control: "directory",
+				hint: "附件的存放根目录。留空＝工作目录下的 media。"
 			}
 		];
 		/** 高级项：默认收起。改错了多半只是自己撞上麻烦，不确定就别动。 */
@@ -103,28 +104,28 @@ window.__ModuleLoader__.load({
 				title: "产物文件名主体 · HELP",
 				tier: "advanced",
 				control: "text",
-				hint: "HELP 文件的文件名主体，后面自动跟时间戳。改它之后旧的 HELP 产物不再被复用。"
+				hint: "HELP 文件名前缀，后面自动加时间戳。"
 			},
 			{
 				key: "files.lookup",
 				title: "产物文件名主体 · 速查表",
 				tier: "advanced",
 				control: "text",
-				hint: "速查表文件的文件名主体。改它之后新产物落新名字，旧的留在原处。"
+				hint: "速查表文件名前缀。"
 			},
 			{
 				key: "lark.cliPath",
 				title: "飞书 CLI 路径",
 				tier: "advanced",
 				control: "text",
-				hint: "飞书 CLI 的可执行文件路径。留空＝按默认落点（自动探测：Windows npm 全局目录 → PATH 里的 where/which → 固定安装位置）。"
+				hint: "飞书 CLI 的可执行文件路径。留空＝自动探测。"
 			},
 			{
 				key: "lark.qrDir",
 				title: "飞书授权二维码落点",
 				tier: "advanced",
-				control: "text",
-				hint: "飞书授权二维码 PNG 的落点目录，缺就现建。留空＝按默认落点（系统临时目录下的 memo_feishu_qr）。"
+				control: "directory",
+				hint: "飞书授权二维码 PNG 的存放目录，缺就现建。留空＝系统临时目录。"
 			}
 		];
 		/** 设置页的行表，顺序即页面顺序。 */
@@ -133,7 +134,7 @@ window.__ModuleLoader__.load({
 		const COMMON_ITEM_COUNT = COMMON.length;
 		/** 高级组标题与副文案。 */
 		const ADVANCED_GROUP_TITLE = "高级";
-		const ADVANCED_GROUP_NOTE = "不常改。留空＝按默认落点（改造前那个位置），不确定就别动。";
+		const ADVANCED_GROUP_NOTE = "不常改。留空＝用默认值。";
 		/** 按 `a.b` 路径从配置取值里读（缺层或类型不符一律回 undefined）。 */
 		function readPath(values, key) {
 			const parts = key.split(".");
@@ -157,6 +158,10 @@ window.__ModuleLoader__.load({
 			cur[parts[parts.length - 1]] = value;
 		}
 		//#endregion
+		//#region src/dsh-ctx.ts
+		/** 宿主目录选择命名空间的服务名（#736；出处与禁令见 cookbook §13）。 */
+		const REMOTE_DIRECTORY_PICKER = "remote.directoryPicker";
+		//#endregion
 		//#region src/client.ts
 		/** dsh-memo-ilife client 适配器（六边形：port=contract+dsh-ctx 镜像，adapter=本文件）。
 		*
@@ -173,9 +178,11 @@ window.__ModuleLoader__.load({
 		* dsh-mattpocock-skills-deck/src/client/panelAssembly.js:100-108
 		* （betterSidebar 服务可能晚于本模块到达，最多 10 次、间隔 1000ms；卸载清理）。
 		* 只用 dsh-ctx 镜像内成员（slots.inject/register、connection.rpc.call 经闭包现取、
-		* betterSidebar 经 ctx.get 运行时取）；取数只经 connection.rpc.call 进 host 通道；
+		* betterSidebar 与 #736 的目录选择命名空间经 ctx.get 运行时取）；取数只经 connection.rpc.call 进 host 通道；
 		* 缺席/错误纯条件渲染，不返空冒充。组件 React.createElement 手写，不引入 JSX。
 		*/
+		/** client 短名声明：只有这两个（#736 的目录选择走**可选查找**，不写进来——
+		* 写进来＝硬依赖，提供方缺席时整包被停靠，设置页会跟着装不上；见 cookbook §13）。 */
 		const inject = ["slots", "connection"];
 		/** 面板视觉（内联 style；颜色走 DSH 主题别名，深浅主题自适应，写死值只做回退）。 */
 		const S = {
@@ -185,11 +192,10 @@ window.__ModuleLoader__.load({
 				border: "1px solid var(--dsw-alias-border, rgba(128,128,128,.35))",
 				background: "var(--dsw-alias-bg-base, transparent)",
 				color: "var(--dsw-alias-label-primary, inherit)",
-				fontSize: 13,
 				lineHeight: 1.6
 			},
 			title: {
-				fontSize: 14,
+				fontSize: "1.08em",
 				fontWeight: 700,
 				marginBottom: 8
 			},
@@ -200,16 +206,16 @@ window.__ModuleLoader__.load({
 			},
 			muted: {
 				color: "var(--dsw-alias-label-secondary, #9a9a9a)",
-				fontSize: 12
+				fontSize: "0.92em"
 			},
 			error: {
 				color: "var(--dsw-alias-state-error-primary, #ff6b6b)",
-				fontSize: 13,
+				fontSize: "1em",
 				whiteSpace: "pre-wrap"
 			},
 			okText: {
 				color: "var(--dsw-alias-state-success-primary, #12805c)",
-				fontSize: 12.5
+				fontSize: "0.96em"
 			},
 			rows: {
 				marginTop: 8,
@@ -217,13 +223,10 @@ window.__ModuleLoader__.load({
 				paddingTop: 8
 			},
 			row: { marginTop: 10 },
-			label: {
-				fontSize: 12.5,
-				fontWeight: 600
-			},
+			label: { fontWeight: 600 },
 			hint: {
 				color: "var(--dsw-alias-label-tertiary, #8a8a8a)",
-				fontSize: 11.5,
+				fontSize: "0.92em",
 				margin: "1px 0 4px"
 			},
 			input: {
@@ -233,14 +236,27 @@ window.__ModuleLoader__.load({
 				borderRadius: 6,
 				border: "1px solid var(--dsw-alias-border, rgba(128,128,128,.45))",
 				background: "var(--dsw-alias-bg-base, transparent)",
+				color: "var(--dsw-alias-label-primary, inherit)"
+			},
+			pickRow: {
+				display: "flex",
+				gap: 6,
+				alignItems: "center"
+			},
+			btnPick: {
+				flex: "0 0 auto",
+				padding: "4px 10px",
+				borderRadius: 6,
+				border: "1px solid var(--dsw-alias-border, rgba(128,128,128,.45))",
+				background: "var(--dsw-alias-bg-base, transparent)",
 				color: "var(--dsw-alias-label-primary, inherit)",
-				font: "12.5px/1.5 ui-monospace,Consolas,monospace"
+				whiteSpace: "nowrap",
+				cursor: "pointer"
 			},
 			info: {
-				margin: "6px 0 0",
-				font: "12px/1.5 ui-monospace,Consolas,monospace",
+				fontSize: "0.92em",
 				color: "var(--dsw-alias-label-secondary, #9a9a9a)",
-				wordBreak: "break-all"
+				overflowWrap: "anywhere"
 			},
 			bar: {
 				marginTop: 14,
@@ -255,7 +271,6 @@ window.__ModuleLoader__.load({
 				border: "1px solid var(--dsw-alias-border, rgba(128,128,128,.45))",
 				background: "var(--dsw-alias-bg-base, transparent)",
 				color: "var(--dsw-alias-label-primary, inherit)",
-				fontSize: 12.5,
 				cursor: "pointer"
 			},
 			btnPrimary: {
@@ -264,7 +279,6 @@ window.__ModuleLoader__.load({
 				border: "1px solid var(--dsw-alias-brand-primary, #2f6fed)",
 				background: "var(--dsw-alias-brand-primary, #2f6fed)",
 				color: "#fff",
-				fontSize: 12.5,
 				cursor: "pointer"
 			},
 			adv: {
@@ -274,7 +288,6 @@ window.__ModuleLoader__.load({
 			},
 			advSummary: {
 				cursor: "pointer",
-				fontSize: 12.5,
 				fontWeight: 600
 			},
 			version: {
@@ -282,7 +295,7 @@ window.__ModuleLoader__.load({
 				paddingTop: 8,
 				borderTop: "1px dashed var(--dsw-alias-border, rgba(128,128,128,.25))",
 				color: "var(--dsw-alias-label-tertiary, #8a8a8a)",
-				fontSize: 12
+				fontSize: "0.92em"
 			}
 		};
 		/** 版本行：插件与技能双版本号（用户要求：每技能设置页自报家门）。 */
@@ -418,11 +431,11 @@ window.__ModuleLoader__.load({
 		*/
 		function humanizeConfigFailure(code, message) {
 			const text = message.trim().length > 0 ? message.trim() : `（${code}，宿主未给报文）`;
-			if (/解析|YAML|parse/i.test(text)) return `${text}\n改回「键: 值」的写法，或点「重置为默认」重来一份（重置会先留一份 .bak）。`;
-			if (/不认识|未知键|UNKNOWN_KEY/i.test(text)) return `${text}\n本页只认表里这些项；多余的行删掉，或点「重置为默认」。`;
-			if (/类型|TYPE_MISMATCH/i.test(text)) return `${text}\n按本页给的形状填（文本填文本），或点「重置为默认」。`;
-			if (/缺席|missing-cli/i.test(text)) return `${text}\n技能出口没找着：先确认技能包已构建（packages/skill-memo-ilife/dist/cli/cmd_read.js）。`;
-			return `${text}\n改不动就点「重置为默认」（会先留一份 .bak），或照报文里的路径手工改配置文件。`;
+			if (/解析|YAML|parse/i.test(text)) return `${text}\n改回「键: 值」的写法，或点「重置为默认」。`;
+			if (/不认识|未知键|UNKNOWN_KEY/i.test(text)) return `${text}\n删掉页面上没有的行，或点「重置为默认」。`;
+			if (/类型|TYPE_MISMATCH/i.test(text)) return `${text}\n按本页的控件形状填，或点「重置为默认」。`;
+			if (/缺席|missing-cli/i.test(text)) return `${text}\n技能出口没找到：先确认技能包已装好，再点「重新读取」。`;
+			return `${text}\n改不动就点「重置为默认」，或照上面那条路径手工改配置文件。`;
 		}
 		/** 一次配置 RPC（同通道过三个端点；永不抛，失败落字）。 */
 		async function configRpc(call, method, payload) {
@@ -472,12 +485,17 @@ window.__ModuleLoader__.load({
 		function resetConfigSurface(call) {
 			return configRpc(call, RPC_ENDPOINT_CONFIG_RESET, {});
 		}
-		/** 把配置取值铺成「行键 → 输入框文本」（页面表单态；值缺项即空串，不返空留白）。 */
-		function toDraft(values) {
+		/** 把配置取值铺成「行键 → 输入框文本」（页面表单态；值缺项即空串，不返空留白）。
+		*
+		* `prefill` 是**落点回执**（配置面那几格解析出来的绝对路径）：标了 `prefillFrom` 的行在取值空着时
+		* 直接显示那条绝对路径——用户不必自己拼路径（#743），显示的就是技能真会用的那个目录（逐字相同）。 */
+		function toDraft(values, prefill = {}) {
 			const draft = {};
 			for (const item of CONFIG_ITEMS) {
 				const v = readPath(values, item.key);
-				draft[item.key] = v === void 0 || v === null ? "" : String(v);
+				const raw = v === void 0 || v === null ? "" : String(v);
+				const fallback = item.prefillFrom === void 0 ? void 0 : prefill[item.prefillFrom];
+				draft[item.key] = raw === "" && typeof fallback === "string" && fallback !== "" ? fallback : raw;
 			}
 			return draft;
 		}
@@ -494,7 +512,73 @@ window.__ModuleLoader__.load({
 			}
 			return values;
 		}
-		/** 一行输入（三种控件对齐受限 YAML 子集：文本／数字／布尔；本包 8 行都是文本）。 */
+		/** 形状守卫：拿到的那个东西像不像目录选择命名空间（本包只认 `pick` 是函数）。 */
+		function isDirectoryPicker(raw) {
+			if (typeof raw !== "object" || raw === null) return false;
+			return typeof raw.pick === "function";
+		}
+		/** 现取目录选择命名空间：**软依赖**，拿不到回 null（页面据此不出入口）。
+		*
+		* 为什么不用 `inject` 声明：见 cookbook §13——写进声明＝硬依赖，提供方缺席时整包被停靠，
+		* 设置页会跟着装不上。这里按平台给的「可选查找」办：缺席只是没有入口。
+		* 守卫拒绝或提供方中途卸载会抛，一律当「没有」，绝不把设置页带下来。 */
+		function resolveDirectoryPicker(getService) {
+			if (typeof getService !== "function") return null;
+			try {
+				const raw = getService(REMOTE_DIRECTORY_PICKER);
+				return isDirectoryPicker(raw) ? raw : null;
+			} catch {
+				return null;
+			}
+		}
+		/** 平台回执 → 三种结果（**永不抛**）。回执是信封 `{ok, value|error}`（见 dsh-ctx.ts 的
+		* `DirectoryPickerAnswer`）：成功回的是 `value` 不是路径本身，被拒回的是 `ok:false` 不是抛——
+		* 照裸值解会把两种情况都误判成「用户取消」（#743 真机现象：点「选择文件夹」什么都没发生）。
+		* 裸串照收（老形状兜底），认不出的形状当「供不了」报出来，不当取消吞掉。 */
+		function readPickAnswer(raw) {
+			if (typeof raw === "string") return raw.trim() === "" ? { kind: "cancelled" } : {
+				kind: "picked",
+				path: raw
+			};
+			const answer = typeof raw === "object" && raw !== null ? raw : {};
+			if (answer.ok === true) {
+				const value = answer.value;
+				return typeof value === "string" && value.trim() !== "" ? {
+					kind: "picked",
+					path: value
+				} : { kind: "cancelled" };
+			}
+			const detail = answer.error?.message?.trim() ?? "";
+			return {
+				kind: "unavailable",
+				message: "打不开系统文件夹对话框" + (detail === "" ? "" : "（" + detail + "）") + "：请直接在框里填绝对路径。"
+			};
+		}
+		/** 唤起一次系统文件夹选择器并归一结果（**永不抛**）。 */
+		async function pickDirectory(picker) {
+			try {
+				return readPickAnswer(await picker.pick());
+			} catch (e) {
+				return {
+					kind: "unavailable",
+					message: "打不开系统文件夹对话框（" + (e instanceof Error ? e.message : String(e)) + "）：请直接在框里填绝对路径。"
+				};
+			}
+		}
+		/** 「选择文件夹」按钮的真装配函数（目录行渲染出来的按钮，onClick 就是它）。
+		*
+		* 回 Promise 是为了本地可判（用例直接 await）；接进 React 时调用方 `void` 掉。 */
+		function createBrowseHandler(deps) {
+			return async (key) => {
+				const outcome = await pickDirectory(deps.picker);
+				if (outcome.kind === "picked") deps.onChange(key, outcome.path);
+				else if (outcome.kind === "unavailable") deps.onUnavailable(outcome.message);
+			};
+		}
+		/** 一行输入（四种控件对齐受限 YAML 子集：文本／数字／布尔／目录）。
+		*
+		* 目录档＝文本框 ＋ 一枚唤起系统文件夹选择器的按钮；`onBrowse` 缺席（命名空间拿不到、
+		* 或这条路已被拒）时不画按钮，文本框照旧——那是该缝自己的契约（供不了就收起入口，不是失败）。 */
 		function Row(props) {
 			const { item } = props;
 			const control = item.control === "switch" ? react.createElement("input", {
@@ -510,7 +594,13 @@ window.__ModuleLoader__.load({
 				spellCheck: false,
 				onChange: (e) => props.onChange(item.key, e.target.value)
 			});
-			return react.createElement("div", { style: S.row }, react.createElement("div", { style: S.label }, item.title), react.createElement("div", { style: S.hint }, item.hint), control);
+			const browse = item.control === "directory" && props.onBrowse !== void 0 ? react.createElement("button", {
+				style: S.btnPick,
+				type: "button",
+				disabled: props.disabled,
+				onClick: () => props.onBrowse?.(item.key)
+			}, "选择文件夹…") : null;
+			return react.createElement("div", { style: S.row }, react.createElement("div", { style: S.label }, item.title), react.createElement("div", { style: S.hint }, item.hint), browse === null ? control : react.createElement("div", { style: S.pickRow }, control, browse));
 		}
 		/** 技能设置页：承载备忘录自己的全部可配置项（只配置，不干活）。
 		*
@@ -518,6 +608,8 @@ window.__ModuleLoader__.load({
 		* 保存与重置之后都**重新读一份整面**再提示（写回执不带 dataDir／created，头部那两行要的是读整面）。 */
 		function MemoConfig(props) {
 			const [state, setState] = react.useState({ kind: "loading" });
+			const [pickerGone, setPickerGone] = react.useState(false);
+			const [picking, setPicking] = react.useState(false);
 			const [draft, setDraft] = react.useState({});
 			const [busy, setBusy] = react.useState(false);
 			const [notice, setNotice] = react.useState(null);
@@ -527,7 +619,7 @@ window.__ModuleLoader__.load({
 					kind: "ready",
 					surface
 				});
-				setDraft(toDraft(surface.values));
+				setDraft(toDraft(surface.values, surface));
 			}, []);
 			const load = react.useCallback(async () => {
 				setNotice(null);
@@ -562,8 +654,26 @@ window.__ModuleLoader__.load({
 				setNotice(null);
 				setError(null);
 			}, []);
+			/** 目录选择：拿不到命名空间就没有入口；被拒一次即收起入口（不留死按钮）。 */
+			const picker = pickerGone ? null : props.getPicker();
+			const onBrowse = react.useMemo(() => {
+				if (picker === null) return void 0;
+				const browse = createBrowseHandler({
+					picker,
+					onChange,
+					onUnavailable: (message) => {
+						setError(message);
+						setPickerGone(true);
+					}
+				});
+				return (key) => {
+					setPicking(true);
+					setError(null);
+					browse(key).finally(() => setPicking(false));
+				};
+			}, [picker, onChange]);
 			const surface = state.kind === "ready" ? state.surface : null;
-			const dirty = surface !== null && CONFIG_ITEMS.some((i) => (draft[i.key] ?? "") !== (toDraft(surface.values)[i.key] ?? ""));
+			const dirty = surface !== null && CONFIG_ITEMS.some((i) => (draft[i.key] ?? "") !== (toDraft(surface.values, surface)[i.key] ?? ""));
 			/** 写完（保存／重置）之后重新读一份整面，读到了才敢提示「已完成」。 */
 			const writeThenReload = react.useCallback(async (done) => {
 				setBusy(true);
@@ -601,7 +711,7 @@ window.__ModuleLoader__.load({
 				if (r.ok) await writeThenReload("已重置为默认（原配置已另存一份 .bak）");
 				else setError(r.message);
 			}, [props.getCall, writeThenReload]);
-			const head = react.createElement("div", null, react.createElement("div", { style: S.title }, `${SLOT_TITLE} · 配置`), surface !== null ? react.createElement("div", null, react.createElement("div", { style: S.info }, `配置文件 ${surface.path}`), react.createElement("div", { style: S.info }, `数据目录 ${surface.dataDir}`), surface.created ? react.createElement("div", { style: S.muted }, "（这份配置是刚按默认值建出来的）") : null) : null);
+			const head = react.createElement("div", null, react.createElement("div", { style: S.title }, `${SLOT_TITLE} · 配置`), surface !== null ? react.createElement("div", null, react.createElement("div", { style: S.info }, `配置文件 ${surface.path}`), react.createElement("div", { style: S.info }, `数据目录 ${surface.dataDir}`), surface.created ? react.createElement("div", { style: S.muted }, "（配置文件刚按默认值生成）") : null) : null);
 			if (state.kind === "loading") return react.createElement("div", { style: S.card }, head, react.createElement("div", { style: S.muted }, "配置读取中…"), react.createElement(VersionLine, null));
 			if (state.kind === "failed") return react.createElement("div", { style: S.card }, react.createElement("div", { style: S.title }, `${SLOT_TITLE} · 配置`), react.createElement("div", { style: S.error }, state.message), react.createElement("div", { style: S.bar }, react.createElement("button", {
 				style: S.btn,
@@ -619,7 +729,8 @@ window.__ModuleLoader__.load({
 				item,
 				value: draft[item.key] ?? "",
 				disabled: busy,
-				onChange
+				onChange,
+				onBrowse
 			});
 			return react.createElement("div", { style: S.card }, head, react.createElement("div", { style: S.rows }, common.map(renderRow)), react.createElement("details", { style: S.adv }, react.createElement("summary", { style: S.advSummary }, ADVANCED_GROUP_TITLE), react.createElement("div", { style: S.muted }, ADVANCED_GROUP_NOTE), advanced.map(renderRow)), react.createElement("div", { style: S.bar }, react.createElement("button", {
 				style: dirty ? S.btnPrimary : S.btn,
@@ -636,17 +747,21 @@ window.__ModuleLoader__.load({
 				type: "button",
 				disabled: busy,
 				onClick: () => void load()
-			}, "重新读取")), notice !== null ? react.createElement("div", { style: S.okText }, notice) : null, error !== null ? react.createElement("div", { style: S.error }, error) : null, react.createElement("div", { style: S.muted }, `${PLUGIN} 设置页住单品包；本页只配置，不干活。`), react.createElement(VersionLine, null));
+			}, "重新读取")), picking ? react.createElement("div", { style: S.muted }, "已唤起系统文件夹对话框：选中后自动填上，取消则不动。") : null, notice !== null ? react.createElement("div", { style: S.okText }, notice) : null, error !== null ? react.createElement("div", { style: S.error }, error) : null, react.createElement("div", { style: S.muted }, `${PLUGIN} 本页只配置；记笔记、搜笔记在对话里说。`), react.createElement(VersionLine, null));
 		}
 		function apply(ctx) {
 			const getCall = () => ctx.connection?.rpc?.call ?? null;
+			const getPicker = () => typeof ctx.get === "function" ? resolveDirectoryPicker((name) => ctx.get?.(name)) : null;
 			ctx.slots.inject("ilife.config-tab", () => ctx.slots.register({
 				name: "ilife.config-tab",
 				id: "dsh-memo-ilife",
 				order: 70,
 				label: () => SLOT_TITLE,
 				channel: RPC_CHANNEL
-			}, () => react.createElement(MemoConfig, { getCall })));
+			}, () => react.createElement(MemoConfig, {
+				getCall,
+				getPicker
+			})));
 			const ensureWorkTab = () => {
 				try {
 					const get = ctx.get;
@@ -681,12 +796,18 @@ window.__ModuleLoader__.load({
 			}
 		}
 		//#endregion
+		exports.Row = Row;
 		exports.apply = apply;
+		exports.createBrowseHandler = createBrowseHandler;
 		exports.fetchConfigSurface = fetchConfigSurface;
 		exports.fromDraft = fromDraft;
 		exports.humanizeConfigFailure = humanizeConfigFailure;
 		exports.inject = inject;
+		exports.isDirectoryPicker = isDirectoryPicker;
+		exports.pickDirectory = pickDirectory;
+		exports.readPickAnswer = readPickAnswer;
 		exports.resetConfigSurface = resetConfigSurface;
+		exports.resolveDirectoryPicker = resolveDirectoryPicker;
 		exports.saveConfigSurface = saveConfigSurface;
 		exports.toDraft = toDraft;
 		return module.exports;