dsh-redteam-memory 0.4.0

package/tools/build-lib.mjs

@@ -0,0 +1,86 @@
+// 生成 lib/host.js 与 lib/client.js。
+//
+// 为什么要生成而不是手写：src/host.js 与 src/client.js 是权威实现，lib/ 只是它们在
+// 【常驻插件包】形态下的包装。手抄两份必然漂移；生成保证「改 src → 跑一次 npm run build:lib」即同步。
+//
+// 两半边的包装差异都集中在垫片里，主体逻辑逐字不动：
+//   host   : harness.defineTool/registerTool/handle  -> defineTool / ctx.tools.register / HTTP 路由
+//   client : host.call（闭包符号）-> fetch 到宿主路由；styles.insert（闭包符号）-> 自插 <style>
+//
+// 用法: node tools/build-lib.mjs [--check]
+//   --check 只比对、不写入，不一致时非零退出（可用于 CI）
+
+import fs from 'node:fs'
+import path from 'node:path'
+
+const root = path.join(import.meta.dirname, '..')
+const read = (p) => fs.readFileSync(path.join(root, p), 'utf8')
+const check = process.argv.includes('--check')
+
+// 插件名从包自身推导：pkg 名去掉 'dsh-' 前缀即界面/工具标识，
+// 这样生成器可被任意包复用，不必逐包改字符串。
+const PKG = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'))
+const PKG_NAME = PKG.name
+const PLUGIN_NAME = PKG_NAME.replace(/^dsh-/, '')
+// RPC 路由挂在包命名空间下，避免与其它插件的路由相撞。
+const ROUTE_BASE = '/' + PKG_NAME
+
+const CLIENT_WRAPPER = "\nreturn {\n  name: '" + PLUGIN_NAME + "',\n  inject: ['slots', 'timer'],\n  apply: applyClient\n}\n"
+
+function strip(source, wrapper, file) {
+  if (!source.endsWith(wrapper)) {
+    console.error(`build-lib: ${file} 结尾与预期不符，无法剥离动态包装`)
+    process.exit(1)
+  }
+  return source.slice(0, -wrapper.length)
+}
+
+// 模板里的占位符按包替换（模板因此可跨包复用）
+function fill(text) {
+  return text
+    .split('__PKG_NAME__').join(PKG_NAME)
+    .split('__PLUGIN_NAME__').join(PLUGIN_NAME)
+    .split('__ROUTE_BASE__').join(ROUTE_BASE)
+}
+
+// ── Host 半边 ────────────────────────────────────────────────────────────────
+const hostHead = read('lib/parts/host.head.js')
+const hostTail = read('lib/parts/host.tail.js')
+// 本插件的 src/host.js 只写 applyHost 的函数体（函数头与收尾由 lib/parts 提供），
+// 因此这里不做「剥离动态包装」——那个包装是 asset-graph 那种内联插件对象才有的。
+let hostOut = fill(hostHead + read('src/host.js') + hostTail)
+
+// ── Client 半边 ──────────────────────────────────────────────────────────────
+// 垫片注入到主体自己的 applyClient 开头，包装保持极薄（只做作用域与导出）。
+const clientHead = read('lib/parts/client.head.js')
+const clientShim = read('lib/parts/client.shim.js')
+const clientTail = read('lib/parts/client.tail.js')
+const ANCHOR = 'function applyClient(ctx) {\n  const slots = ctx.slots\n'
+let clientBody = strip(read('src/client.js'), CLIENT_WRAPPER, 'src/client.js')
+if (clientBody.split(ANCHOR).length !== 2) {
+  console.error('build-lib: src/client.js 中未找到唯一的 applyClient 入口锚点')
+  process.exit(1)
+}
+clientBody = clientBody.replace(ANCHOR, clientShim + '  const slots = ctx.slots\n')
+let clientOut = fill(clientHead + clientBody + clientTail)
+
+
+
+const targets = [
+  ['lib/host.js', hostOut],
+  ['lib/client.js', clientOut],
+]
+
+let bad = 0
+for (const [rel, content] of targets) {
+  const abs = path.join(root, rel)
+  if (check) {
+    const current = fs.existsSync(abs) ? fs.readFileSync(abs, 'utf8') : ''
+    if (current !== content) { console.error(`build-lib --check: ${rel} 与 src/ 不同步`); bad++ }
+    else console.log(`build-lib --check: ${rel} 同步`)
+  } else {
+    fs.writeFileSync(abs, content, 'utf8')
+    console.log(`build-lib: 已生成 ${rel}（${Buffer.byteLength(content)} 字节）`)
+  }
+}
+process.exit(bad === 0 ? 0 : 1)

package/tools/prepare-gh-packages.mjs

@@ -0,0 +1,66 @@
+// 为 GitHub Packages 生成发布副本。
+//
+// 为什么需要这个脚本：GitHub Packages 要求包名是作用域形式，且作用域必须等于仓库属主
+// （这里 owner = Fasthei，故只能叫 @fasthei/…）。而 npmjs 不允许发布不属于自己的 scope，
+// 因此同一个包在这两个 registry 上必须是**两个名字**：
+//
+//   npmjs            -> dsh-redteam-asset-graph            （未作用域，公开、可被搜索）
+//   GitHub Packages  -> @fasthei/dsh-redteam-asset-graph   （作用域名，需属主）
+//
+// 与其手抄两份 package.json（必然漂移），不如由本脚本从唯一的 package.json 生成副本，
+// 只替换 name 与 publishConfig：其余字段（dsh.bundle/client/dynamic、exports、files…）
+// 逐字继承，保证两个 registry 上的包行为一致。
+//
+// 用法:
+//   node tools/prepare-gh-packages.mjs            # 生成到 build/gh-packages/
+//   然后在 build/gh-packages/ 下执行 npm publish
+
+import fs from 'node:fs'
+import path from 'node:path'
+
+const root = path.join(import.meta.dirname, '..')
+const OUT = path.join(root, 'build', 'gh-packages')
+
+const OWNER = 'fasthei'
+const GH_SCOPE = '@' + OWNER
+
+const base = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'))
+const baseName = base.name
+const scopedName = `${GH_SCOPE}/${baseName}`
+
+const manifest = {
+  ...base,
+  name: scopedName,
+  publishConfig: {
+    registry: 'https://npm.pkg.github.com',
+    // 作用域包在 GitHub Packages 上默认是 private；显式声明 public 才能被他人安装。
+    access: 'public',
+  },
+}
+
+// 递归复制发布所需内容（只复制 files 白名单 + 清单），与 npm pack 的口径一致。
+function copyListed(rel) {
+  const src = path.join(root, rel)
+  const dst = path.join(OUT, rel)
+  if (!fs.existsSync(src)) {
+    console.warn(`prepare-gh-packages: 跳过缺失项 ${rel}`)
+    return
+  }
+  const st = fs.statSync(src)
+  if (st.isDirectory()) {
+    fs.mkdirSync(dst, { recursive: true })
+    for (const entry of fs.readdirSync(src)) copyListed(path.join(rel, entry))
+  } else {
+    fs.mkdirSync(path.dirname(dst), { recursive: true })
+    fs.copyFileSync(src, dst)
+  }
+}
+
+fs.rmSync(OUT, { recursive: true, force: true })
+fs.mkdirSync(OUT, { recursive: true })
+for (const rel of base.files ?? []) copyListed(rel)
+fs.writeFileSync(path.join(OUT, 'package.json'), JSON.stringify(manifest, null, 2) + '\n', 'utf8')
+
+console.log(`prepare-gh-packages: ${baseName}@${base.version} -> ${scopedName}`)
+console.log(`prepare-gh-packages: registry = https://npm.pkg.github.com`)
+console.log(`prepare-gh-packages: 输出目录 = ${path.relative(root, OUT)}`)