Genarrative/apps/ai-game-creator-shell/tests/chatDialogFrameLayout.test.ts

// @vitest-environment jsdom
import { readFileSync } from 'node:fs';

import { describe, expect, it } from 'vitest';

import { repoPath } from './repoPath';
import {
  declaration,
  parseStyleSheet,
  resolveDeclarations,
} from './styleCascade';

const STYLES_PATH = repoPath('apps/ai-game-creator-shell/src/styles.css');
const CHAT_VIEW_PATH = repoPath(
  'apps/ai-game-creator-shell/src/view/project-development/chat/DirectProjectChatView.tsx',
);
const CHAT_CONVERSATION_PATH = repoPath(
  'apps/ai-game-creator-shell/src/view/project-development/chat/components/DirectProjectConversation/DirectProjectConversation.tsx',
);
const CHAT_COMPOSER_PATH = repoPath(
  'apps/ai-game-creator-shell/src/view/project-development/chat/components/DirectProjectComposer/DirectProjectComposer.tsx',
);

function lengthPx(rawValue: string, label: string): number {
  const value = rawValue.trim();
  // CSS 里 0 可以不带单位，其余一律要求 px（本文件不写 rem/em 几何）。
  if (value === '0') {
    return 0;
  }
  const match = /^(-?\d+(?:\.\d+)?)px$/u.exec(value);
  expect(match, `${label} 不是像素值：${value}`).not.toBeNull();
  return Number(match![1]);
}

function pixelValue(
  declarations: Map<string, string>,
  property: string,
): number {
  return lengthPx(declaration(declarations, property), property);
}

/** 展开 `padding`：长写优先（后面的长写会覆盖简写），没有长写再拆简写。 */
function paddingBox(declarations: Map<string, string>) {
  const sides: Array<['top' | 'right' | 'bottom' | 'left', number]> = [
    ['top', 0],
    ['right', 0],
    ['bottom', 0],
    ['left', 0],
  ];
  const longhand = new Map<string, number>();
  for (const [side] of sides) {
    if (declarations.has(`padding-${side}`)) {
      longhand.set(side, pixelValue(declarations, `padding-${side}`));
    }
  }
  const shorthand = declarations.get('padding');
  const shorthandValues = new Map<string, number>();
  if (shorthand) {
    const parts = shorthand.split(' ').filter(Boolean);
    const value = (index: number) => {
      const part = parts[index] ?? parts[parts.length - 1] ?? parts[0];
      return lengthPx(part!, `padding 简写 ${shorthand}`);
    };
    if (parts.length === 1) {
      const only = value(0);
      for (const [side] of sides) {
        shorthandValues.set(side, only);
      }
    } else if (parts.length === 2) {
      shorthandValues.set('top', value(0));
      shorthandValues.set('bottom', value(0));
      shorthandValues.set('right', value(1));
      shorthandValues.set('left', value(1));
    } else if (parts.length === 3) {
      shorthandValues.set('top', value(0));
      shorthandValues.set('right', value(1));
      shorthandValues.set('bottom', value(2));
      shorthandValues.set('left', value(1));
    } else {
      shorthandValues.set('top', value(0));
      shorthandValues.set('right', value(1));
      shorthandValues.set('bottom', value(2));
      shorthandValues.set('left', value(3));
    }
  }
  const resolved = {} as Record<string, number>;
  for (const [side] of sides) {
    const value = longhand.get(side) ?? shorthandValues.get(side);
    expect(value, `缺少生效声明 padding-${side}`).toBeDefined();
    resolved[side] = value!;
  }
  return resolved as {
    top: number;
    right: number;
    bottom: number;
    left: number;
  };
}

/** 展开 `margin` 简写，只关心四边数值。 */
function marginBox(declarations: Map<string, string>) {
  const shorthand = declarations.get('margin') ?? '0';
  const parts = shorthand.split(' ').filter(Boolean);
  const value = (index: number) => {
    const part = parts[index] ?? parts[parts.length - 1] ?? parts[0];
    return lengthPx(part!, `margin 简写 ${shorthand}`);
  };
  if (parts.length === 1) {
    const only = value(0);
    return { top: only, right: only, bottom: only, left: only };
  }
  if (parts.length === 2) {
    return { top: value(0), right: value(1), bottom: value(0), left: value(1) };
  }
  if (parts.length === 3) {
    return { top: value(0), right: value(1), bottom: value(2), left: value(1) };
  }
  return { top: value(0), right: value(1), bottom: value(2), left: value(3) };
}

/**
 * 展开 `gap` 简写，只关心主/交叉两轴。
 *
 * 一值写四个方向同一个数；两值先 `row-gap` 后 `column-gap`（与 CSS 的 `gap: <row> <column>`
 * 一致）。三层输入区里两条行间距分别写在输入盒与输入盒自己身上，读值时必须分得清是哪一条。
 */
function gapBox(declarations: Map<string, string>) {
  const shorthand = declarations.get('gap') ?? '0';
  const parts = shorthand.split(' ').filter(Boolean);
  const value = (index: number) => {
    const part = parts[index] ?? parts[parts.length - 1] ?? parts[0];
    return lengthPx(part!, `gap 简写 ${shorthand}`);
  };
  return { row: value(0), column: value(1) };
}

/* ============================================================
   选择器身份
   ============================================================ */

const CHAT = '.game-workbench-chat .project-chat-surface.is-direct-codex';
const SURFACE = CHAT;
const CONVERSATION = `${CHAT} .project-chat-conversation`;
const MESSAGE_LIST = `${CHAT} .project-chat-message-list`;
const MESSAGE_LIST_PLAIN = '.game-workbench-chat .project-chat-message-list';
const COMPOSER = `${CHAT} .project-chat-composer.is-direct-codex`;
const COMPOSER_PLAIN = `${CHAT} .project-chat-composer`;
const CONVERSATION_COMPOSER = `${CONVERSATION} .project-chat-composer.is-direct-codex`;
const COMPOSER_INPUT = `${COMPOSER} .resource-reference-input`;
const COMPOSER_INPUT_PLAIN = `${COMPOSER_PLAIN} .resource-reference-input`;
const COMPOSER_EDITOR = `${COMPOSER_INPUT} .resource-reference-input-editor`;
const COMPOSER_EDITOR_PLAIN = `${COMPOSER_PLAIN} .resource-reference-input-editor`;
const COMPOSER_CONTROLS = `${COMPOSER} .project-chat-composer-controls`;
const COMPOSER_SUBMIT = `${COMPOSER_CONTROLS} .project-chat-submit-button`;
/** 模型触发钮：工具栏那一排里最高的一颗（30px），行高由它决定而不是发送钮（28px）。 */
const COMPOSER_TRIGGER = `${COMPOSER_CONTROLS} .conversation-model-trigger`;
/** 触发钮的基础几何规则挂在 `.project-chat-composer`（不带 `.is-direct-codex`）上，同样命中。 */
const COMPOSER_TRIGGER_BASE =
  '.project-chat-surface.is-direct-codex .project-chat-composer .conversation-model-trigger';
const INPUT_ACTIONS = `${COMPOSER_INPUT} .resource-reference-input-actions`;
const INPUT_ACTIONS_PLAIN = `${COMPOSER} .resource-reference-input-actions`;
const TOPBAR = `${CHAT} .project-chat-topbar`;
/** 列表实际会命中的全部选择器：direct-codex 直连与基础规则。 */
const LIST_SELECTORS = [MESSAGE_LIST, MESSAGE_LIST_PLAIN];

const DESKTOP = 1440;
const MOBILE = 390;

const styles = readFileSync(STYLES_PATH, 'utf8');
const rules = parseStyleSheet(styles);

function desktopDeclarations(...elementSelectors: string[]) {
  return resolveDeclarations(rules, elementSelectors, DESKTOP);
}

function mobileDeclarations(...elementSelectors: string[]) {
  return resolveDeclarations(rules, elementSelectors, MOBILE);
}

/**
 * 输入盒在文档流里的最高高度。
 *
 * 新结构里输入盒**不再**需要消息列表给它让位，这个值只用来给「列表底边不留白」做
 * 下界校验：留白只要不小于它就说明旧模型的数字被写回来了。
 */
function composerMaxHeight() {
  const composer = desktopDeclarations(COMPOSER, COMPOSER_PLAIN);
  const input = desktopDeclarations(
    COMPOSER_INPUT,
    COMPOSER_INPUT_PLAIN,
    '.resource-reference-input',
  );
  const editor = desktopDeclarations(
    COMPOSER_EDITOR,
    COMPOSER_EDITOR_PLAIN,
    '.resource-reference-input-editor',
  );
  const actions = desktopDeclarations(INPUT_ACTIONS, INPUT_ACTIONS_PLAIN);
  const polishButton = desktopDeclarations(
    `${INPUT_ACTIONS} .resource-reference-input-polish`,
    '.resource-reference-input-polish',
  );
  const controls = desktopDeclarations(COMPOSER_CONTROLS);
  const submit = desktopDeclarations(COMPOSER_SUBMIT);
  const trigger = desktopDeclarations(COMPOSER_TRIGGER, COMPOSER_TRIGGER_BASE);

  const editorMaxHeight = pixelValue(editor, 'max-height');
  const actionsRowHeight = pixelValue(polishButton, 'height');
  // 输入盒与输入盒外各有一条行间距：前者是「文字区 / 操作排」之间，后者是
  // 「输入内容区 / 工具栏」之间（三层布局，见 styles.css 文件末尾的输入区区块）。
  const inputRowGap = gapBox(input).row;
  const composerRowGap = gapBox(composer).row;
  const inputPaddingBottom = paddingBox(input).bottom;
  const composerPaddingTop = paddingBox(composer).top;
  const composerPaddingBottom = paddingBox(composer).bottom;
  // 工具栏行高由这一排里**最高的一颗控件**决定：模型触发钮 30px 高于发送 / 语音的
  // 28px（`align-items: center` 只做居中，不会把行高压回 28）。所以这里取两者最大值，
  // 而不是写死某一颗钮的高度——改任一颗的尺寸都会自动反映到算式里。
  expect(
    controls.has('padding-top'),
    '工具栏与输入区之间的间距由输入盒的 row-gap 提供，不再用 padding-top',
  ).toBe(false);
  expect(
    pixelValue(trigger, 'height'),
    '工具栏行高由模型触发钮决定，改了要重新核对这条算式',
  ).toBe(30);
  const controlsRowHeight = Math.max(
    pixelValue(submit, 'height'),
    pixelValue(trigger, 'height'),
  );

  expect(
    pixelValue(editor, 'min-height'),
    '编辑器最小高度是输入盒高度的下界，改了要同步改这里的算式',
  ).toBe(72);
  // 操作排的高度就是那三只 28px 方钮自己撑起来的：它自己不设 height / min-height，
  // 一旦设了，网格行高会被顶起来、编辑器的 min-height 也跟着变，算式随之作废。
  expect(actions.has('height')).toBe(false);
  expect(actions.has('min-height')).toBe(false);
  // 操作排必须是网格里的第二行，不能再绝对定位浮到文字上（issue #600 的回归点）。
  expect(declaration(actions, 'position')).toBe('static');
  expect(declaration(actions, 'grid-row')).toBe('2');
  expect(declaration(actions, 'grid-column')).toBe('2');

  return {
    actionsRowHeight,
    total:
      composerPaddingTop +
      editorMaxHeight +
      inputRowGap +
      actionsRowHeight +
      inputPaddingBottom +
      composerRowGap +
      controlsRowHeight +
      composerPaddingBottom,
  };
}

describe('陶泥儿对话区：Codex 三段式（顶栏 / 唯一滚动区 / 文档流输入盒）', () => {
  it('输入盒在消息列表下方、处于文档流，四边留白一致且与消息内容左右对齐（宽屏）', () => {
    const list = desktopDeclarations(...LIST_SELECTORS);
    const composer = desktopDeclarations(COMPOSER, COMPOSER_PLAIN);
    const surface = desktopDeclarations(SURFACE);

    // 列表是唯一滚动区：自身不再绝对定位，靠 flex 吸收会话列的剩余高度。
    expect(declaration(list, 'position')).toBe('relative');
    expect(declaration(list, 'overflow-y')).toBe('auto');
    expect(declaration(list, 'flex')).toContain('1 1 auto');

    // 输入盒在文档流里：不绝对定位；关键是它不再落在列表**内部**覆盖消息。
    expect(declaration(composer, 'position')).toBe('relative');

    // 用户可见契约：四边留白必须一致。
    // 面板自身 padding 必须归 0，否则「左右留白」会等于「面板 padding + 输入盒左右外边距」，
    // 而「上/下留白」只等于外边距或面板 padding——两边口径不同就一定会再次出现
    // 「左右一个值、上下另一个值」的不齐（实测就是这个现象）。
    expect(paddingBox(surface).top).toBe(0);
    expect(paddingBox(surface).right).toBe(0);
    expect(paddingBox(surface).bottom).toBe(0);
    expect(paddingBox(surface).left).toBe(0);
    const insets = marginBox(composer);
    expect(insets.top, '输入盒与消息列表之间必须有留白').toBe(16);
    expect(insets.right).toBe(16);
    expect(insets.bottom).toBe(16);
    expect(insets.left).toBe(16);
    // 左右留白还要与消息内容一致：列表自身左右各 16px（下面也有断言），三者同一基准。
    expect(paddingBox(list).left).toBe(insets.left);
    expect(paddingBox(list).right).toBe(insets.right);
    // 盒内上下内边距同样必须相等，不能再写 `8px … 10px` 那种上下不一致的写法。
    {
      const composerPadding = paddingBox(composer);
      expect(composerPadding.top).toBe(composerPadding.bottom);
    }
    // 也不再靠 bottom/left/right 偏移量定位（那是旧浮层几何的残余）。
    expect(pixelValue(composer, 'bottom')).toBe(0);
    expect(pixelValue(composer, 'left')).toBe(0);
    expect(pixelValue(composer, 'right')).toBe(0);

    // 输入盒自己那只盒子还在（它现在是整块面板里唯一有边框的容器）。
    expect(declaration(composer, 'border')).toContain('1px solid');
    expect(declaration(composer, 'background')).toContain(
      'var(--platform-input-fill)',
    );
    expect(declaration(composer, 'border-radius')).toBe('14px');

    // 对话内容左右留白 16px，消息之间 14px。
    expect(paddingBox(list).left).toBe(16);
    expect(paddingBox(list).right).toBe(16);
    expect(declaration(list, 'gap')).toBe('14px');
  });

  it('消息列表底部不留给浮层的空白，滚动到底不会多出一段空白（宽屏）', () => {
    const list = desktopDeclarations(...LIST_SELECTORS);
    const { total, actionsRowHeight } = composerMaxHeight();

    // 输入盒最高高度由真实声明算出来（三层布局，自上而下）：
    // 盒内上内边距 12 + 编辑器 160 + 输入区行距 6 + 操作排 28 + 输入区下内边距 0
    // + 输入盒与工具栏的行距 8 + 工具栏 30（模型触发钮撑起来的行高）+ 盒内下内边距 12 = 256。
    expect(actionsRowHeight, '操作排按钮高度变了就要重算下面的算式').toBe(28);
    expect(pixelValue(desktopDeclarations(COMPOSER_SUBMIT), 'height')).toBe(28);
    expect(total).toBe(256);

    const paddingBottom = paddingBox(list).bottom;
    // 新契约：留白归 0。旧版这里是一条 `inset + 输入区最高高度 + 间距` 的算式，
    // 输入盒回到文档流之后，那段留白会变成凭空多出来的空白，把最后一条消息顶出可视区。
    expect(paddingBottom, '输入盒在文档流里，列表底边不允许再给浮层留白').toBe(
      0,
    );
    expect(pixelValue(list, 'scroll-padding-bottom')).toBe(paddingBottom);
    // 留白必须严格小于输入盒高度，否则就是把旧模型的数字又写回来了。
    expect(paddingBottom).toBeLessThan(total);
  });

  it('思维强度：触发钮留在工具条同一排，档位收进 popover 的滑块（宽屏）', () => {
    const trigger = desktopDeclarations(
      `${COMPOSER} .project-chat-composer-strength-trigger`,
      COMPOSER_TRIGGER,
      COMPOSER_TRIGGER_BASE,
    );
    const anchor = desktopDeclarations(
      `${COMPOSER} .project-chat-composer-strength`,
    );
    const popover = desktopDeclarations(
      `${COMPOSER} .project-chat-composer-strength-popover`,
    );
    const range = desktopDeclarations(
      `${COMPOSER} .project-chat-composer-strength-range`,
    );

    // 触发钮沿用工具条那颗 30px 控件的高度和类：工具条行高仍是 30（见上面的算式）。
    expect(pixelValue(trigger, 'height')).toBe(30);
    // 浮层锚在强度控件上、从工具条上方展开，不占工具条宽度；滑块占满浮层宽度。
    expect(declaration(anchor, 'position')).toBe('relative');
    expect(declaration(popover, 'position')).toBe('absolute');
    expect(declaration(popover, 'bottom')).toBe('calc(100% + 8px)');
    expect(declaration(range, 'width')).toBe('100%');
  });

  it('窄屏（390px）输入盒仍在文档流、四周有边距，列表底部没有留白', () => {
    const conversation = mobileDeclarations(CONVERSATION);
    const list = mobileDeclarations(...LIST_SELECTORS);
    const composer = mobileDeclarations(
      COMPOSER,
      COMPOSER_PLAIN,
      CONVERSATION_COMPOSER,
    );
    const topbar = mobileDeclarations(TOPBAR);

    // 会话列不再自画一只外框：那块框交给输入盒，避免"框里再套一只框"。
    const framePadding = paddingBox(conversation);
    expect(framePadding.top).toBe(0);
    expect(framePadding.right).toBe(0);
    expect(framePadding.bottom).toBe(0);
    expect(framePadding.left).toBe(0);
    expect(declaration(conversation, 'border')).toBe('0');
    expect(declaration(conversation, 'background')).toBe('transparent');

    // 输入盒仍在文档流（本来就在），四边留白与宽屏同一套值（16px），窄屏不再另给一组
    // `8px 12px 12px` 的不对称外边距。
    expect(declaration(composer, 'position')).toBe('relative');
    expect(declaration(composer, 'bottom')).toBe('auto');
    expect(declaration(composer, 'left')).toBe('auto');
    expect(declaration(composer, 'right')).toBe('auto');
    const composerMargin = marginBox(composer);
    expect(composerMargin.top, '窄屏输入盒四周都要有边距').toBe(16);
    expect(composerMargin.left).toBe(16);
    expect(composerMargin.right).toBe(16);
    expect(composerMargin.bottom).toBe(16);

    // 列表在窄屏也不画框、不留浮层空白，它仍是唯一滚动区。
    expect(declaration(list, 'background')).toBe('transparent');
    expect(pixelValue(list, 'padding-bottom')).toBe(0);
    expect(declaration(list, 'overflow-y')).toBe('auto');

    // 顶栏在窄屏也在场（状态点 + 设置钮），高度不塌。
    expect(declaration(topbar, 'display')).toBe('flex');
    expect(pixelValue(topbar, 'min-height')).toBe(44);
  });

  it('输入盒仍落在 form.project-chat-composer 子树里，交互控件原位', () => {
    const viewSource = readFileSync(CHAT_VIEW_PATH, 'utf8');
    const conversationSource = readFileSync(CHAT_CONVERSATION_PATH, 'utf8');
    const composerSource = readFileSync(CHAT_COMPOSER_PATH, 'utf8');

    // 面板三段式的顺序：顶栏 → 会话区 → 输入盒，组合顺序由视图持有。
    const conversationOpen = viewSource.indexOf(
      '<div className="project-chat-conversation">',
    );
    expect(conversationOpen).toBeGreaterThanOrEqual(0);
    const headerIndex = viewSource.indexOf(
      '<DirectProjectChatHeader',
      conversationOpen,
    );
    const bodyIndex = viewSource.indexOf(
      '<DirectProjectConversation',
      conversationOpen,
    );
    const composerIndex = viewSource.indexOf(
      '<DirectProjectComposer',
      conversationOpen,
    );
    expect(headerIndex).toBeGreaterThan(conversationOpen);
    expect(bodyIndex, '会话区必须排在顶栏之后').toBeGreaterThan(headerIndex);
    expect(composerIndex, '输入盒必须排在会话区之后').toBeGreaterThan(
      bodyIndex,
    );

    // 唯一滚动区仍是消息列表；`[overflow-anchor:none]` 是滚动补偿契约的一部分
    // （见 `docs/adr/【ADR】DirectProject对话滚动与历史自动加载-2026-10-02.md`），
    // 原生 scroll anchoring 一旦重新打开就会和会话侧补偿互相抵消。
    expect(conversationSource).toContain(
      'className="message-list project-chat-message-list [overflow-anchor:none]"',
    );

    const formOpen = composerSource.indexOf('<form');
    expect(formOpen, '输入盒（form）缺失').toBeGreaterThanOrEqual(0);
    const formEnd = composerSource.indexOf('</form>');
    expect(formEnd, '输入盒（form）没有闭合').toBeGreaterThan(formOpen);
    const formSource = composerSource.slice(
      formOpen,
      formEnd + '</form>'.length,
    );

    // 编辑器、`+` / `@` 引用、模型选择、提交按钮全在这棵子树里，位置只由样式挪。
    expect(formSource).toContain('ResourceReferenceInput');
    // 输入盒里不再有「项目名 · 本地」信息标签行（按需求删除）。
    expect(formSource).not.toContain('project-chat-composer-context');
    expect(formSource).toContain('project-chat-composer-controls');
    expect(formSource).toContain('project-chat-reference-trigger');
    expect(formSource).toContain('ConversationModelSelect');
    expect(formSource).toContain('onSubmit={');
    // 提交按钮本体还是那只按钮，只是以变量形式引用进这棵子树。
    expect(composerSource).toContain('className="project-chat-submit-button"');
  });

  /**
   * 面板纵向必须撑满 `.game-workbench-chat` 的高度。
   *
   * 这里锁的是一次真实渲染事故：`.game-workbench-chat` 是
   * `grid-template-rows: auto minmax(0, 1fr)`（原本给「头部 + 内容」两行用），direct-codex
   * 精简掉头部后对话面板成了第一个子元素、落进第一行 auto 轨道。面板高度一旦大于
   * 内容（新会话只有一条欢迎消息时就是如此），面板就被压成内容高度——消息列表塌成几十像素、
   * 输入盒被拉伸到两百多像素。实测修法是让面板跨全部行（`grid-row: 1 / -1`）并靠
   * `height: 100%` 撑满轨道；`flex: 0 1 auto` 之类的 flex 简写会把 basis 变回 auto，同样塌。
   */
  it('面板撑满对话列高度，消息列表不再被压成内容高度', () => {
    const chat = desktopDeclarations('.game-workbench-chat');
    const surface = desktopDeclarations(
      '.game-workbench-chat .project-chat-surface',
    );
    const list = desktopDeclarations('.project-chat-message-list');
    const listInPanel = desktopDeclarations(MESSAGE_LIST_PLAIN);
    const listInPanelDirectCodex = desktopDeclarations(MESSAGE_LIST);

    // 对话列仍是两行 grid：面板必须跨全部行，否则只能拿到 auto 行的高度。
    expect(declaration(chat, 'display')).toBe('grid');
    expect(declaration(surface, 'grid-row')).toBe('1 / -1');
    expect(declaration(surface, 'height')).toBe('100%');
    // flex 简写会把 basis 变回 auto，面板又会塌成内容高度。
    expect(surface.has('flex')).toBe(false);

    // 基础规则 `.project-chat-message-list { min-height: 340px }` 给列表压了下限；
    // 面板里真正生效的是后写的 96px，而 direct-codex 面板必须把它解除到 0——
    // 否则空对话时列表被顶高、输入盒被挤出面板（实测就是 panel 的 4564px 那次）。
    expect(pixelValue(list, 'min-height')).toBe(340);
    expect(pixelValue(listInPanel, 'min-height')).toBe(96);
    expect(pixelValue(listInPanelDirectCodex, 'min-height')).toBe(0);
  });
});

describe('策划对话：消息伸缩与长内容边界', () => {
  function planningDeclarations(className: string, width: number) {
    const root = document.createElement('div');
    root.innerHTML = `<div class="window-chrome"><div class="window-chrome__content">
      <div class="launcher-shell platform-theme"><aside></aside><main class="launcher-main">
      <section class="launcher-page launcher-project-development game-project-workbench game-project-workbench--design">
      <div class="game-workbench-layout game-workbench-layout--design">
      <section class="game-workbench-stage"><div class="design-workspace-panel">
        <div class="design-workspace-panel__body"><div class="design-workspace-tree"></div></div>
      </div></section>
      <aside class="game-workbench-chat"><header>策划</header>
        <section class="project-chat-surface"><div class="project-chat-conversation">
          <section class="design-agent-controls"></section>
          <header class="project-chat-topbar"><span class="project-chat-topbar-status">
            <span class="project-chat-topbar-dot"></span><span>已打开：项目</span>
          </span></header>
          <div class="message-list project-chat-message-list"></div>
          <section class="design-agent-pending-actions"></section>
          <form class="project-chat-composer"><p class="project-chat-composer-notice"></p></form>
        </div></section>
      </aside></div></section></main></div></div></div>`;
    const element = root.querySelector(className)!;
    // 从 DOM 匹配完整选择器，防止遗漏基础规则或误把 Direct 专用样式算到策划入口。
    const selectors = rules.flatMap((rule) =>
      rule.selectors.filter((selector) => {
        try {
          return element.matches(selector);
        } catch {
          // jsdom 不支持的浏览器伪类与本面板无关。
          return false;
        }
      }),
    );
    return resolveDeclarations(rules, selectors, width);
  }

  it.each([1440, 390])(
    '%ipx：消息吸收剩余高度，状态和输入区不参与拉伸',
    (width) => {
      const conversation = planningDeclarations(
        '.project-chat-conversation',
        width,
      );
      const list = planningDeclarations('.project-chat-message-list', width);
      const composer = planningDeclarations('.project-chat-composer', width);
      const topbar = planningDeclarations('.project-chat-topbar', width);
      expect(declaration(conversation, 'display')).toBe('flex');
      expect(declaration(conversation, 'flex-direction')).toBe('column');
      expect(declaration(conversation, 'height')).toBe('100%');
      expect(declaration(conversation, 'overflow')).toBe('visible');
      expect(declaration(list, 'flex')).toBe('1 1 0');
      expect(declaration(list, 'min-height')).toBe('0');
      expect(declaration(list, 'overflow-y')).toBe('auto');
      expect(declaration(composer, 'flex')).toBe('0 0 auto');
      expect(declaration(topbar, 'flex')).toBe('0 0 auto');
      expect(declaration(topbar, 'min-height')).toBe('44px');
      expect(
        declaration(
          planningDeclarations('.project-chat-topbar-status', width),
          'font-size',
        ),
      ).toBe('12px');
      expect(
        declaration(
          planningDeclarations(
            '.project-chat-topbar-status > span:last-child',
            width,
          ),
          'overflow-wrap',
        ),
      ).toBe('anywhere');
      for (const selector of [
        '.design-agent-controls',
        '.design-agent-pending-actions',
      ]) {
        const panel = planningDeclarations(selector, width);
        expect(declaration(panel, 'max-height')).toBe('30%');
        expect(declaration(panel, 'min-height')).toBe('0');
        expect(declaration(panel, 'overflow')).toBe('auto');
      }
    },
  );

  it.each([390, 760])(
    '%ipx：固定外壳内工作台可滚动到对话，两块面板保持明确高度',
    (width) => {
      const workbench = planningDeclarations('.game-project-workbench', width);
      const layout = planningDeclarations('.game-workbench-layout', width);
      const stage = planningDeclarations('.game-workbench-stage', width);
      const chat = planningDeclarations('.game-workbench-chat', width);
      expect(declaration(workbench, 'min-height')).toBe('0');
      expect(declaration(workbench, 'overflow-y')).toBe('auto');
      expect(declaration(workbench, 'overflow-x')).toBe('hidden');
      expect(declaration(layout, 'height')).toBe('auto');
      expect(declaration(layout, 'grid-template-columns')).toBe(
        'minmax(0, 1fr)',
      );
      expect(declaration(stage, 'height')).toBe('560px');
      expect(declaration(chat, 'height')).toBe(
        'clamp(560px, calc(100dvh - 154px), 900px)',
      );
      expect(
        declaration(
          planningDeclarations('.design-workspace-panel', width),
          'height',
        ),
      ).toBe('100%');
      expect(
        declaration(
          planningDeclarations('.design-workspace-tree', width),
          'overflow',
        ),
      ).toBe('auto');
    },
  );

  it.each([761, 1280])('%ipx：双栏继续填满外壳剩余高度', (width) => {
    const workbench = planningDeclarations('.game-project-workbench', width);
    const layout = planningDeclarations('.game-workbench-layout', width);
    expect(declaration(workbench, 'overflow')).toBe('hidden');
    expect(workbench.has('overflow-y')).toBe(false);
    expect(declaration(layout, 'height')).toBe('100%');
    expect(declaration(layout, 'grid-template-columns')).toBe(
      'minmax(0, 1fr) minmax(380px, 0.42fr)',
    );
  });

  it('批量导入失败提示可滚动且可换行，不撑高输入区或撑宽面板', () => {
    const notice = planningDeclarations('.project-chat-composer-notice', 390);
    expect(declaration(notice, 'max-height')).toBe('96px');
    expect(declaration(notice, 'overflow')).toBe('auto');
    expect(declaration(notice, 'overflow-wrap')).toBe('anywhere');
  });
});