@morlay/dsh-desktop-shell 0.0.1-alpha.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 morlay
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,34 @@
+# @morlay/dsh-desktop-shell
+
+dsh 桌面应用的 **Electron 壳**：服务应用自己的 `<name>://` 协议，经字节管道（FD 3/4）把 desktop profile 交给
+host 子进程 [`@morlay/dsh-desktop-host`](../dsh-desktop-host/README.md) 启动，并在首次启动 / 种子指纹变化时把
+profile 种进 `DSH_HOME`。
+
+它**不单独跑**——启动与打包它的是 [`@morlay/dsh-desktopify`](../dsh-desktopify/README.md)：
+
+- `dsh-desktopify dev` 以**本包目录**为 Electron app 启动（Electron 按本包清单的 `main` 找到 `dist/index.mjs`）；
+- `dsh-desktopify bundle` 把本包的 `dist/` 复制成最小壳 app 目录再交给 electron-builder。
+
+边界与拆分理由见[设计 壳独立成包](./.agents/designs/20260924-壳独立成包.md)。
+
+## 出口
+
+| 出口                | 用途                                                                |
+| ------------------- | ------------------------------------------------------------------- |
+| `.`                 | 壳入口（`dist/index.mjs`，Electron 主进程），由 `main` 与它一起指到 |
+| `./appconfig`       | `appconfig.json` 读写与 profile patch 文件名                        |
+| `./dshhome`         | `dshHome` 语义解析（`xdg` / `env` / 路径）                          |
+| `./official`        | 官方包清单与 host 变体包名（壳与工具的同一份事实）                  |
+| `./profile-project` | profile 工程（`pnpm-workspace.yaml`、overrides、清单）              |
+| `./seed`            | 种子布局与指纹                                                      |
+
+后五个是工具侧复用同一份实现的入口——种子、官方包清单、home 解析都只有这一份，壳与 CLI 都引它。
+
+## 依赖边界
+
+壳产物整份进 `app.asar`，那里只有壳自己的字节（`@local/*` 与 `@morlay/dsh-desktop-host` 构建期内联），上游包
+一律留在产物外。因此**壳入口可达的模块只能 import node 内建、`electron` 与那两个内联面**——上游裸引用能过类型
+检查、能打出产物，但装进 asar 后解析不到，只在真机启动时炸。守卫：
+[`shell-import-boundary.spec.ts`](./src/__tests__/shell-import-boundary.spec.ts)。
+
+preload 必须是 CJS（sandboxed preload 的约束），所以它单独一遍构建；壳主进程与它产在同一次 `pnpm build`。

package/dist/appconfig-B4kozO2F.mjs

@@ -0,0 +1,43 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+//#region src/appconfig.ts
+const PROFILE_NAME = "desktop";
+/**
+* profile 自己的 patch 文档名（上游 `PROFILE_PATCH_FILENAME` 的同值）。
+* 常量放在这里而不是 import 上游：`seed.ts` 会被打进壳产物（`app.asar`），
+* 那里解析不到 `@deepseek-ai/*`——上游裸引用会让应用启动即 `ERR_MODULE_NOT_FOUND`。
+*/
+const PROFILE_PATCH_NAME = "cordis.patch.yml";
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+function windowConfig(value) {
+	const record = isRecord(value) ? value : {};
+	return {
+		width: numberOr(record.width, 1280),
+		height: numberOr(record.height, 800),
+		minWidth: numberOr(record.minWidth, 800),
+		minHeight: numberOr(record.minHeight, 600)
+	};
+}
+function numberOr(value, fallback) {
+	return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : fallback;
+}
+async function loadAppConfig(exeDir) {
+	const path = join(exeDir, "appconfig.json");
+	const value = JSON.parse(await readFile(path, "utf8"));
+	if (!isRecord(value) || typeof value.name !== "string" || value.name === "" || typeof value.id !== "string" || value.id === "" || typeof value.version !== "string" || value.version === "" || value.profile !== "desktop" || value.dshHome !== "xdg" && value.dshHome !== "env" && typeof value.dshHome !== "string") throw new Error(`dsh desktop: invalid shell configuration ${path}`);
+	return {
+		name: value.name,
+		id: value.id,
+		version: value.version,
+		profile: PROFILE_NAME,
+		dshHome: value.dshHome,
+		window: windowConfig(value.window)
+	};
+}
+async function writeAppConfig(exeDir, config) {
+	await writeFile(join(exeDir, "appconfig.json"), `${JSON.stringify(config, void 0, 2)}\n`, { mode: 384 });
+}
+//#endregion
+export { writeAppConfig as i, PROFILE_PATCH_NAME as n, loadAppConfig as r, PROFILE_NAME as t };

package/dist/appconfig.mjs

@@ -0,0 +1,2 @@
+import { i as writeAppConfig, n as PROFILE_PATCH_NAME, r as loadAppConfig, t as PROFILE_NAME } from "./appconfig-B4kozO2F.mjs";
+export { PROFILE_NAME, PROFILE_PATCH_NAME, loadAppConfig, writeAppConfig };

package/dist/dshhome-C_iyJzc8.mjs

@@ -0,0 +1,26 @@
+import { isAbsolute, join, resolve } from "node:path";
+import { homedir } from "node:os";
+//#region src/dshhome.ts
+function xdgDataHome() {
+	if (process.platform === "darwin") return join(homedir(), "Library", "Application Support");
+	const configured = process.env.XDG_DATA_HOME;
+	if (configured !== void 0 && configured.trim() !== "") return resolve(configured);
+	return join(homedir(), ".local", "share");
+}
+/**
+* 解析 `dshHome` 的三态：`xdg`（平台数据目录 + app 名）、`env`（交给环境，这里没有具体路径）、
+* 绝对路径。打包壳与 dev CLI（`--home`）共用这一份，措辞与校验只写在这里。
+*/
+function resolveConfiguredHome(name, spec) {
+	if (spec === "env") return void 0;
+	if (spec === "xdg") return join(xdgDataHome(), name);
+	if (!isAbsolute(spec)) throw new Error(`dsh desktop: dshHome must be xdg, env, or an absolute path, got ${JSON.stringify(spec)}`);
+	return spec;
+}
+function resolveDshHome(config) {
+	const override = process.env.DSH_APP_DSH_HOME;
+	if (override !== void 0 && override.trim() !== "") return resolve(override);
+	return resolveConfiguredHome(config.name, config.dshHome);
+}
+//#endregion
+export { resolveDshHome as n, xdgDataHome as r, resolveConfiguredHome as t };

package/dist/dshhome.mjs

@@ -0,0 +1,2 @@
+import { n as resolveDshHome, r as xdgDataHome, t as resolveConfiguredHome } from "./dshhome-C_iyJzc8.mjs";
+export { resolveConfiguredHome, resolveDshHome, xdgDataHome };