gamekit777 0.1.5 → 0.1.7

package/studio/preview/entry.ts

@@ -3,7 +3,7 @@
  * 壳就是 dev-host 的 DevShell——和 `bun run dev` 看到的是同一个参考平台，同一条本地表模型：
  * 浏览器里就地建表、按权重抽行、restore 还原。studio 多接的只有三样：
  * 建好的正式产物（有就优先用）、存为 case、以及 node 侧的总线（MCP 的 preview_* 工具从那儿进来）。 */
-import { runDevShell, parseTable, localServer, type LoadedTable, type PlatformOf } from 'gamekit777/dev-host';
+import { runDevShell, parseTable, localServer, layoutFromSearch, safeFromSearch, type LoadedTable, type PlatformOf } from 'gamekit777/dev-host';
 import type { GameModule } from 'gamekit777/sdk';
 import game from 'virtual:studio/game';
 import { api, connectBridge } from './bridge.ts';
@@ -23,6 +23,10 @@ let p: PlatformOf<object, unknown> | null = null;
 runDevShell(g, {
   // 嵌入模式：页眉和余额由 studio 页面画，这里只剩机台和机台下面的开发面板
   embedded: true,
+  /* 布局默认桌面，不按窗口判——iframe 有多宽由 studio 页面决定。首载从 ?layout= 读，之后由 set 命令就地切；
+     ?safe= 是设备预设模拟的刘海，iframe 里 env() 拿不到 */
+  layout: layoutFromSearch(location.search) ?? 'desktop',
+  simSafe: safeFromSearch(location.search) ?? undefined,
   server: localServer({ spec: g, external }),
   onPlatform: (plat) => { p = plat; },
   onSaveCase: async (h, title) => {
@@ -39,6 +43,7 @@ const snapshot = (): Record<string, unknown> => {
   return {
     config: plain(p.config), mode: p.tableMode, bet: p.bet, balance: p.balance, pnl: p.pnl,
     status: plain(p.game), lastError: p.err, tableModes: plain(p.tableModes),
+    layout: p.layout, stage: plain(p.stage),
     recent: p.history.slice(0, 10).map((h) => ({ n: h.n, mode: h.mode, multiplier: h.multiplier, payout: h.payout, simId: h.simId, ok: h.checks.every((c) => c.ok) })),
   };
 };
@@ -60,6 +65,10 @@ const bridge = connectBridge({
         if (cmd.clientSeed !== undefined) { plat.clientSeed = String(cmd.clientSeed); applied.push('clientSeed'); }
         if (cmd.skin !== undefined) { plat.setView({ skin: String(cmd.skin) }); applied.push('skin'); }
         if (cmd.turbo !== undefined) { plat.setView({ turbo: !!cmd.turbo }); applied.push('turbo'); }
+        if (cmd.layout !== undefined) {
+          if (cmd.layout === 'desktop' || cmd.layout === 'mobile') { plat.setLayout(cmd.layout); applied.push('layout'); }
+          else rejected.push({ key: 'layout', reason: '只能是 desktop / mobile' });
+        }
         return { applied, rejected, state: snapshot() };
       }
       case 'play': {

package/studio/src/engine.ts

@@ -5,6 +5,7 @@
 import { existsSync, readFileSync, readdirSync, statSync, writeFileSync } from 'node:fs';
 import { join, relative } from 'node:path';
 import { Sha256 } from 'gamekit777/sdk/hash';
+import type { StageInfo, StageLayout } from 'gamekit777/sdk';
 import type { Segment } from 'gamekit777/weights';
 import { Bus } from './bus.ts';
 import { buildMode, groupsSummary, listArtifacts, readArtifactBytes, sampleMode, type Artifact, type BuildModeOptions } from './build.ts';
@@ -31,6 +32,9 @@ export interface PreviewState {
   lastError: string | null;
   recent: unknown[];
   consoleErrors: string[];
+  /** 机台布局与交给游戏的舞台（含安全区）。页面的切换按钮和 MCP 的 preview_set 都以这里为准 */
+  layout: StageLayout | null;
+  stage: StageInfo | null;
   updatedAt: number;
 }
 
@@ -85,7 +89,7 @@ export class Engine {
   readonly assets: AssetStore;
   preview: PreviewState = {
     connected: false, config: null, mode: null, bet: null, balance: null,
-    status: null, lastError: null, recent: [], consoleErrors: [], updatedAt: 0,
+    status: null, lastError: null, recent: [], consoleErrors: [], layout: null, stage: null, updatedAt: 0,
   };
   #publish = new Map<string, PublishRequest>();
   #lastFingerprint: string;

package/studio/src/mcp.ts

@@ -145,12 +145,12 @@ export function createMcpServer(engine: Engine): McpServer {
   });
 
   s.registerTool('scaffold', {
-    description: '在当前目录下新建一个游戏（my-game，占了加序号；一个能跑的抛硬币），写好 package.json 并 bun install。名字之后改 game.meta.json。请在那个目录里重启 studio。',
-    inputSchema: {},
-  }, async () => {
+    description: '新建一个游戏（能跑的抛硬币）并 bun install。不给 name 就在当前目录就地生成（当前目录必须是空的，id 取目录名）；给 name 就生成到子目录 ./name。当前目录已经是项目时会拒绝并让你给名字。标题之后改 game.meta.json。生成后要在那个目录里重启 studio。',
+    inputSchema: { name: z.string().optional().describe('子目录名，同时是 id（小写短横线）。不给 = 用当前目录') },
+  }, async (a) => {
     try {
-      const r = await scaffold({}, process.cwd());
-      return out(`## ✅ 已生成 ${r.dest}\n\n${r.files} 个文件，依赖${r.installed ? '已装' : '未装'}。\n\n${r.next.map((n) => `- ${n}`).join('\n')}`, r);
+      const r = await scaffold({ name: a.name }, process.cwd());
+      return out(`## ✅ ${r.inPlace ? `已就地生成在 ${r.dest}` : `已生成 ${r.dest}`}\n\n${r.files} 个文件，依赖${r.installed ? '已装' : '未装'}。\n\n${r.next.map((n) => `- ${n}`).join('\n')}`, r);
     } catch (e) { return fail(e instanceof Error ? e.message : String(e)); }
   });
 
@@ -282,25 +282,27 @@ export function createMcpServer(engine: Engine): McpServer {
   });
 
   s.registerTool('preview_state', {
-    description: '预览页的当前状态：连没连、当前 config / mode / 注额 / 余额、已加载的表、最近几局、控制台报错。',
+    description: '预览页的当前状态：连没连、当前 config / mode / 注额 / 余额、已加载的表、最近几局、控制台报错、机台布局（desktop/mobile）与交给游戏的舞台尺寸和安全区。',
     inputSchema: {},
   }, async () => {
     engine.touch();
     const p = engine.preview;
     if (!engine.bus.previewConnected) return out(`预览页没连着。请在浏览器打开 ${engine.urls.studio}`, { connected: false });
     return out([`## 预览（本地表模型）`, `- mode ${p.mode}，注额 ${p.bet}，余额 ${p.balance}`, `- config ${JSON.stringify(p.config)}`,
+      ...(p.stage ? [`- 布局 ${p.layout}，舞台 ${p.stage.width}×${p.stage.height}，安全区 上 ${p.stage.safe.top} 下 ${p.stage.safe.bottom}`] : []),
       `- 最近 ${p.recent.length} 局`, ...(p.lastError ? [`- ⚠️ 最近错误：${p.lastError}`] : []),
       ...(p.consoleErrors.length ? ['', '### 控制台报错', ...p.consoleErrors.slice(-5).map((e) => `- ${e}`)] : [])].join('\n'), p);
   });
 
   s.registerTool('preview_set', {
-    description: '改预览的设置：config、注额、客户端种子、造型、极速。局中/自动中会被平台否决，rejected 里会说。',
+    description: '改预览的设置：config、注额、客户端种子、造型、极速、机台布局（desktop 桌面 / mobile 手机竖屏全屏）。局中/自动中会被平台否决，rejected 里会说。',
     inputSchema: {
       config: z.record(z.string(), z.unknown()).optional(),
       bet: z.number().int().optional().describe('最小货币单位（分）'),
       clientSeed: z.string().optional(),
       skin: z.string().optional(),
       turbo: z.boolean().optional(),
+      layout: z.enum(['desktop', 'mobile']).optional().describe('切机台布局。游戏不重挂，收到 host.stage 后自己重排'),
     },
   }, async (a) => {
     try {

package/studio/src/scaffold.ts

@@ -3,25 +3,45 @@
  * 这是 MCP 的 scaffold 工具背后的东西。装依赖这一步只有这里会自动做——
  * 别处发现缺 node_modules 一律只提示，不代作者动手。 */
 import { spawn } from 'node:child_process';
-import { existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { basename, join } from 'node:path';
 import { scaffoldGame, ID_PATTERN } from 'gamekit777/create-game';
 
 export const DEFAULT_ID = 'my-game';
 export const DEFAULT_TITLE = '我的游戏';
 
-/** 不给 id 就叫 my-game；占了就 my-game-2、my-game-3……创作者改名只需要动 slug 和目录名 */
-export function defaultId(cwd: string): string {
-  if (!existsSync(join(cwd, DEFAULT_ID))) return DEFAULT_ID;
-  for (let n = 2; ; n++) if (!existsSync(join(cwd, `${DEFAULT_ID}-${n}`))) return `${DEFAULT_ID}-${n}`;
+/** 目录名能当 id 就当 id（同时是 slug 和 CSS 命名空间），不能就退回 my-game */
+export function idFromDir(dir: string): string {
+  const b = basename(dir).toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/^-+|-+$/g, '');
+  return ID_PATTERN.test(b) ? b : DEFAULT_ID;
+}
+
+/** 当前目录像不像一个已有的项目：有这些就别往里铺模板 */
+export function looksLikeProject(dir: string): string | null {
+  for (const f of ['package.json', 'game.ts', 'src', 'vite.config.ts']) if (existsSync(join(dir, f))) return f;
+  return null;
+}
+
+/**
+ * 不带名字时的目标就是 cwd 本身：AI 通常已经站在它要建的目录里，再套一层 my-game 只会让它 cd 错地方。
+ * cwd 已经是个项目、或者有别的文件，就拒绝并让它给名字——不猜、不覆盖
+ */
+export function resolveTarget(cwd: string, name?: string): { id: string; dest: string; inPlace: boolean } {
+  if (name) {
+    if (!ID_PATTERN.test(name)) throw new Error(`名字 "${name}" 要是小写短横线形式（a-z 0-9 -），它同时是 slug、目录名和 CSS 命名空间`);
+    return { id: name, dest: join(cwd, name), inPlace: false };
+  }
+  const hit = looksLikeProject(cwd);
+  if (hit) throw new Error(`当前目录 ${cwd} 已经是一个项目（有 ${hit}）。要在它里面新建就给个名字：gamekit777 new <名字>`);
+  const others = readdirSync(cwd).filter((f) => !f.startsWith('.') && !['README.md', 'LICENSE', 'CLAUDE.md'].includes(f));
+  if (others.length) throw new Error(`当前目录 ${cwd} 不是空的（有 ${others.slice(0, 5).join('、')}${others.length > 5 ? '…' : ''}）。在空目录里跑，或给个名字：gamekit777 new <名字>`);
+  return { id: idFromDir(cwd), dest: cwd, inPlace: true };
 }
 
 export interface ScaffoldRequest {
-  /** 不给就是 my-game（占了就加序号） */
-  id?: string;
+  /** 子目录名，同时是 id。不给就在 cwd 里就地生成，id 取自目录名 */
+  name?: string;
   title?: string;
-  /** 目标目录。默认 <cwd>/<id> */
-  dest?: string;
   /** package.json 里 gamekit777 的版本说明符。仓库内是 workspace:*，创作者机器上是版本号 */
   gamekitSpec?: string;
   /** 跳过 bun install */
@@ -30,6 +50,9 @@ export interface ScaffoldRequest {
 
 export interface ScaffoldResult {
   dest: string;
+  id: string;
+  /** true = 就地生成在 cwd，不用再 cd */
+  inPlace: boolean;
   files: number;
   installed: boolean;
   installOutput: string;
@@ -71,9 +94,7 @@ function defaultSpec(dest: string): string {
 }
 
 export async function scaffold(req: ScaffoldRequest, cwd: string): Promise<ScaffoldResult> {
-  const id = req.id ?? defaultId(cwd);
-  if (!ID_PATTERN.test(id)) throw new Error(`id "${id}" 要是小写短横线形式`);
-  const dest = req.dest ?? join(cwd, id);
+  const { id, dest, inPlace } = resolveTarget(cwd, req.name);
   const r = scaffoldGame({ id, title: req.title ?? DEFAULT_TITLE, dest, gamekitSpec: req.gamekitSpec ?? defaultSpec(dest) });
 
   let installed = false, installOutput = '';
@@ -84,9 +105,11 @@ export async function scaffold(req: ScaffoldRequest, cwd: string): Promise<Scaff
   }
 
   return {
-    dest, files: r.files.length, installed, installOutput,
+    dest, id, inPlace, files: r.files.length, installed, installOutput,
     next: [
-      `游戏在 ${dest}，是一个能跑的抛硬币。从能跑的东西开始改；名字和标题在 game.meta.json 里改。`,
+      inPlace
+        ? `就地生成在当前目录 ${dest}（id = ${id}，取自目录名），不用 cd。是一个能跑的抛硬币；名字和标题在 game.meta.json 里改。`
+        : `游戏在 ${dest}（id = ${id}），是一个能跑的抛硬币。从能跑的东西开始改；名字和标题在 game.meta.json 里改。`,
       `先读 ${join(dest, 'CLAUDE.md')}：清单字段、round() 的硬约束、modes/book/restore 怎么选、演出侧约定。`,
       '改 src/rules/ 下的纯逻辑（零 DOM、零自取随机），改 src/components/ 下的演出。',
       '已发布过的 mode 解码逻辑不能改，要改就换 slug；结果漂移由 studio/cases.jsonl 兜。',

package/studio/src/studio-plugin.ts

@@ -5,9 +5,7 @@
  *
  * 不往游戏目录写任何文件：两个 html 从内存吐，入口用 /@fs 指回 studio 包。
  * 不依赖游戏目录里有 index.html：脚手架出来的项目没有它，`bun run dev` 就是起 studio。 */
-import { readFileSync } from 'node:fs';
-import type { Plugin } from 'vite';
-import { compile } from 'svelte/compiler';
+import type { DevEnvironment, Plugin, Rollup } from 'vite';
 import { API_PREFIX, createApi } from './api.ts';
 import type { Engine } from './engine.ts';
 
@@ -55,18 +53,36 @@ export function studioPlugin(o: StudioPluginOptions): Plugin {
       return null;
     },
 
-    /* 资源库组件的 <style> 兜底。vite-plugin-svelte 把组件 CSS 存在模块信息里，样式虚拟模块
-       （…svelte?svelte&type=style&lang.css）从那里取；组件还没编译过就先来要样式（重连、刷新、缓存未命中）时
-       它拿不到，退回读文件——整份 .svelte 源码被当 CSS 交给下游，namespace-css 直接炸页。
-       库组件在游戏根之外、内容自足，这里自己编一遍只取 CSS：scoped class 的哈希只由样式文本决定，和组件那次编译一致 */
-    load(id) {
+    /* svelte 组件 <style> 的兜底。
+       vite-plugin-svelte 把编译出的 CSS 挂在组件模块的 meta 上，样式虚拟模块（…svelte?svelte&type=style&lang.css）
+       用 getModuleInfo(不带 query 的文件名) 去取。两种情况取不到，它就放弃，vite 退回读文件——
+       整份 .svelte 源码被当 CSS 交给下游：模板里的 `{#if}` 变成一条条空规则，`<style>` 里的选择器没有 hash，页面整个走样。
+         1. 装成 npm 包后 gamekit777 在游戏的 node_modules 里，vite 给这类模块 id 加 ?v=<hash>，文件名对不上 id。
+            仓库内是符号链接到 packages/，走 /@fs 路径没有 ?v=，所以只有创作者机器上才坏。
+         2. 组件还没编译过就先来要样式（资源库现场编译、重连、刷新）。
+       这里按文件名在模块图里找那次编译留下的 CSS；没有就先把组件本身 transform 一遍再找——
+       不能自己 compile 一遍只取 CSS：dev 下 vite-plugin-svelte 用文件名算 scope hash（s-xxx），
+       默认的按内容算（svelte-xxx），两边对不上，等于没修。 */
+    async load(id) {
       const m = /^([^?]+\.svelte)\?(?:.*&)?svelte(?:&.*)?&type=style(?:&|$)/.exec(id) ?? /^([^?]+\.svelte)\?(?:.*&)?type=style(?:&|$)/.exec(id);
       const file = m?.[1];
-      if (!file || !file.startsWith(o.engine.assets.dir)) return null;
-      try {
-        const src = readFileSync(file, 'utf8');
-        return { code: compile(src, { filename: file, generate: 'client', css: 'external' }).css?.code ?? '' };
-      } catch { return null; }
+      if (!file) return null;
+      const env = this.environment;
+      if (env.mode !== 'dev') return null;
+      const dev = env as DevEnvironment;
+      const pick = (): { code: string; map: Rollup.SourceMapInput | undefined; moduleType: 'css' } | null => {
+        for (const mod of dev.moduleGraph.getModulesByFile(file) ?? []) {
+          // 插件写的 meta 落在 info.meta 上（vite 的 ModuleInfo 代理），mod.meta 是另一份、可能是空的
+          const meta = (mod.info?.meta ?? mod.meta) as { svelte?: { css?: { code?: string; map?: Rollup.SourceMapInput } } } | undefined;
+          const css = meta?.svelte?.css;
+          if (typeof css?.code === 'string') return { code: css.code, map: css.map, moduleType: 'css' };
+        }
+        return null;
+      };
+      const hit = pick();
+      if (hit) return hit;
+      try { await dev.transformRequest(`/@fs${file}`); } catch { return null; }
+      return pick();
     },
 
     configureServer(server) {

package/create-game/template/game.meta.json.tmpl

@@ -1,8 +0,0 @@
-{
-  "id": "__ID__",
-  "title": "__TITLE__",
-  "version": "1.0.0",
-  "aspect": "16:9",
-  "orientation": "any",
-  "fonts": []
-}

package/create-game/template/tsconfig.json

@@ -1,22 +0,0 @@
-{
-  "extends": "@tsconfig/svelte/tsconfig.json",
-  "compilerOptions": {
-    "target": "ES2022",
-    "lib": ["ES2022", "DOM", "DOM.Iterable"],
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "strict": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noImplicitOverride": true,
-    "noFallthroughCasesInSwitch": true,
-    "noEmit": true,
-    "isolatedModules": true,
-    "verbatimModuleSyntax": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "allowImportingTsExtensions": true,
-    "types": ["vite/client"]
-  },
-  "include": ["src", "test", "scripts", "*.ts"]
-}