@joplo-app/server 0.0.0-stage → 0.1.1

package/dist/web-assets.js

@@ -0,0 +1,127 @@
+/**
+ * 看板与发布站资源在哪里（D36）。两种形态：
+ *
+ * - source：在仓库里从 TS 源码运行（`pnpm joplo …`、测试）。Vite 直接编译 packages/web/src，界面本身也能热更新。
+ * - dist：从 npm 安装的包运行。资源是 @joplo-app/web 发包前预构建的 dist/（见 packages/web/scripts/build-dist.mjs），
+ *   运行时不读取 packages/web/src。作者的 className 用 dist/project.css 现场编译（Tailwind，@source 指向项目目录）。
+ *
+ * 选择规则：本文件以 .ts 运行且 packages/web/src 存在 → source；否则 dist。`JOPLO_WEB=dist` 可在仓库里强制 dist
+ * （用于验证预构建产物）。
+ */
+import fs from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { JoploError } from '@joplo-app/core';
+const require = createRequire(import.meta.url);
+const FROM_SOURCE = import.meta.filename.endsWith('.ts');
+const REPO_WEB = path.resolve(import.meta.dirname, '../../web');
+const REPO_KIT = path.resolve(import.meta.dirname, '../../kit/src');
+const broken = (webDir, what) => new JoploError('NOT_FOUND', `@joplo-app/web（${webDir}）缺少预构建资源：${what}。请重新安装 joplo（npm install），或在 Joplo 仓库里运行 pnpm --filter @joplo-app/web build`);
+/** 读取并校验 @joplo-app/web 的 dist/manifest.json。 */
+export function readWebDist(webDir) {
+    const dist = path.join(webDir, 'dist');
+    const manifestFile = path.join(dist, 'manifest.json');
+    let manifest;
+    try {
+        manifest = JSON.parse(fs.readFileSync(manifestFile, 'utf8'));
+    }
+    catch {
+        throw broken(webDir, 'dist/manifest.json');
+    }
+    if (manifest.format !== 1)
+        throw broken(webDir, `不认识的清单格式 ${String(manifest.format)}`);
+    const inside = (rel, label) => {
+        if (typeof rel !== 'string' || !rel)
+            throw broken(webDir, label);
+        const abs = path.resolve(dist, rel);
+        if (abs !== dist && !abs.startsWith(dist + path.sep))
+            throw broken(webDir, `${label} 越出了 dist/`);
+        if (!fs.existsSync(abs))
+            throw broken(webDir, `dist/${rel}`);
+        return abs;
+    };
+    const board = inside(manifest.board, 'board');
+    inside(manifest.site, 'site');
+    const projectCss = inside(manifest.projectCss, 'projectCss');
+    const appDir = path.dirname(board);
+    let siteFiles;
+    try {
+        siteFiles = JSON.parse(fs.readFileSync(inside(manifest.siteFiles, 'siteFiles'), 'utf8'));
+    }
+    catch (e) {
+        if (e instanceof JoploError)
+            throw e;
+        throw broken(webDir, 'site-files.json 不是合法 JSON');
+    }
+    if (!Array.isArray(siteFiles) || !siteFiles.every((f) => typeof f === 'string' && f && !path.isAbsolute(f) && !f.split(/[\\/]/).includes('..')))
+        throw broken(webDir, 'site-files.json 应为 appDir 内的相对路径列表');
+    return { mode: 'dist', webDir, appDir, siteFiles, projectCss, version: typeof manifest.version === 'string' ? manifest.version : '' };
+}
+let cached = null;
+/** 看板与发布站资源。结果按进程缓存（env 只在首次调用时生效；测试可传入 env 绕过缓存）。 */
+export function locateWebAssets(env) {
+    if (!env && cached)
+        return cached;
+    const e = env ?? process.env;
+    let out;
+    if (FROM_SOURCE && e.JOPLO_WEB !== 'dist' && fs.existsSync(path.join(REPO_WEB, 'src/main.tsx')))
+        out = { mode: 'source', webDir: REPO_WEB, indexCss: path.join(REPO_WEB, 'src/index.css'), kitSrc: REPO_KIT };
+    else {
+        let pkg;
+        try {
+            pkg = require.resolve('@joplo-app/web/package.json');
+        }
+        catch {
+            throw new JoploError('NOT_FOUND', '找不到 @joplo-app/web（看板与发布站资源）。请重新安装 joplo（npm install）');
+        }
+        out = readWebDist(path.dirname(fs.realpathSync(pkg)));
+    }
+    if (!env)
+        cached = out;
+    return out;
+}
+/** 作者 className 的 CSS 入口（source：packages/web/src/index.css；dist：@joplo-app/web/dist/project.css）。 */
+export const cssEntry = (web) => (web.mode === 'source' ? web.indexCss : web.projectCss);
+/** Tailwind 的 index.css，从 server 自己的依赖解析（pnpm 严格布局下 @joplo-app/web 没有 tailwindcss 依赖）。 */
+export function tailwindIndexCss() {
+    return require.resolve('tailwindcss/index.css');
+}
+/** 从 dir 起向上找 node_modules/<name>/package.json（与 Node 的包解析顺序一致，不依赖 exports）。 */
+export function findPackageJson(dir, name) {
+    let cur = path.resolve(dir);
+    for (;;) {
+        const f = path.join(cur, 'node_modules', name, 'package.json');
+        if (fs.existsSync(f))
+            return f;
+        const parent = path.dirname(cur);
+        if (parent === cur)
+            return null;
+        cur = parent;
+    }
+}
+const KIT_SUBPATHS = ['ui', 'node', 'jsx-runtime', 'jsx-dev-runtime'];
+/**
+ * 项目源文件里的 `@joplo-app/kit` 怎样解析：
+ * - source：指向仓库里的 kit 源码（项目可在任意目录，不需要自己的 node_modules）；`@/` 指向 web 源码。
+ * - dist：项目装了 @joplo-app/kit 就按项目依赖解析（与 `joplo check` 用的 tsx 一致）；没装则退回 CLI 自带的 kit。
+ */
+export function kitAliases(web, projectDir) {
+    if (web.mode === 'source')
+        return [
+            { find: /^@joplo-app\/kit$/, replacement: path.join(web.kitSrc, 'index.ts') },
+            { find: /^@joplo-app\/kit\/(ui|node|jsx-runtime|jsx-dev-runtime)$/, replacement: path.join(web.kitSrc, '$1.ts') },
+            { find: /^@\//, replacement: path.join(web.webDir, 'src') + '/' },
+        ];
+    if (findPackageJson(projectDir, '@joplo-app/kit'))
+        return [];
+    const main = fileURLToPath(import.meta.resolve('@joplo-app/kit'));
+    const sub = fileURLToPath(import.meta.resolve(`@joplo-app/kit/${KIT_SUBPATHS[0]}`));
+    if (path.dirname(main) !== path.dirname(sub))
+        throw new JoploError('NOT_FOUND', `@joplo-app/kit 的入口不在同一目录：${main}、${sub}`);
+    const ext = path.extname(main);
+    return [
+        { find: /^@joplo-app\/kit$/, replacement: main },
+        { find: /^@joplo-app\/kit\/(ui|node|jsx-runtime|jsx-dev-runtime)$/, replacement: path.join(path.dirname(main), `$1${ext}`) },
+    ];
+}

package/package.json

@@ -1,6 +1,56 @@
 {
   "name": "@joplo-app/server",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Joplo 本地服务：dev 看板、build 发布站、render 截图",
+  "license": "Apache-2.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@joplo-app/core": "0.1.1",
+    "@joplo-app/kit": "0.1.1",
+    "@joplo-app/web": "0.1.1",
+    "@tailwindcss/vite": "4.3.4",
+    "tailwindcss": "4.3.4",
+    "vite": "8.3.5",
+    "zod": "4.6.7"
+  },
+  "peerDependencies": {
+    "playwright": "^1.64.1"
+  },
+  "peerDependenciesMeta": {
+    "playwright": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@vitejs/plugin-react": "6.2.1",
+    "playwright": "1.64.1"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Joplo-app/Joplo.git",
+    "directory": "packages/server"
+  },
+  "homepage": "https://github.com/Joplo-app/Joplo#readme",
+  "bugs": {
+    "url": "https://github.com/Joplo-app/Joplo/issues"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-package.mjs"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.