@nelsonlongxiang/dsh-open-a2a-net 0.6.41 → 0.6.42

package/nexus-stage/src/seat-name-editor.ts

@@ -1,31 +1,31 @@
-/** Human owner form only: labels never grant membership or become routing ids. */
-export function createSeatNameEditor(sessions: readonly { id: string; name?: string; label?: string }[], names: Record<string, string>, save: (names: Record<string, string>) => Promise<{ ok: boolean; error?: string }>): HTMLElement {
-  const box = document.createElement('section')
-  const heading = document.createElement('h4'); heading.textContent = '会话席位名（仅人工设定）'; box.appendChild(heading)
-  const note = document.createElement('p'); note.className = 'wb-hint'; note.textContent = '稳定展示名，不改变会话标题、路由句柄或准入。留空并保存可清除。'; box.appendChild(note)
-  const select = document.createElement('select'); select.setAttribute('aria-label', '选择命名的本机会话')
-  for (const id of new Set([...sessions.map(row => row.id), ...Object.keys(names)])) {
-    const row = sessions.find(row => row.id === id), option = document.createElement('option')
-    option.value = id; option.textContent = (names[id] ?? row?.name ?? row?.label ?? id) + ' · ' + id; select.appendChild(option)
-  }
-  const input = document.createElement('input'); input.type = 'text'; input.maxLength = 64; input.setAttribute('aria-label', '人工席位名'); input.placeholder = '例如：开发席'
-  const button = document.createElement('button'); button.type = 'submit'; button.textContent = '保存席位名'; button.className = 'wb-member-submit'
-  const form = document.createElement('form'); form.className = 'wb-member-add'; form.append(select, input, button)
-  const status = document.createElement('p'); status.className = 'wb-hint'; status.setAttribute('role', 'status'); status.setAttribute('aria-live', 'polite')
-  let pending = false
-  const load = () => { input.value = names[select.value] ?? ''; button.disabled = pending || select.value === '' }
-  select.addEventListener('change', load); load()
-  form.addEventListener('submit', async event => {
-    event.preventDefault(); if (pending || select.value === '') return
-    const id = select.value, value = input.value.trim(), next = { ...names }
-    if (value === '') delete next[id]; else next[id] = value
-    pending = true; button.disabled = true; select.disabled = true; input.disabled = true
-    try {
-      const result = await save(next)
-      if (result.ok) { delete names[id]; if (value !== '') names[id] = value; status.textContent = '席位名已保存；目录将随状态刷新。' }
-      else status.textContent = result.error ?? '保存失败'
-    } catch (error) { status.textContent = '保存失败：' + String(error) }
-    finally { pending = false; select.disabled = false; input.disabled = false; load() }
-  })
-  box.append(form, status); return box
-}
+/** Human owner form only: labels never grant membership or become routing ids. */
+export function createSeatNameEditor(sessions: readonly { id: string; name?: string; label?: string }[], names: Record<string, string>, save: (names: Record<string, string>) => Promise<{ ok: boolean; error?: string }>): HTMLElement {
+  const box = document.createElement('section')
+  const heading = document.createElement('h4'); heading.textContent = '会话席位名（仅人工设定）'; box.appendChild(heading)
+  const note = document.createElement('p'); note.className = 'wb-hint'; note.textContent = '稳定展示名，不改变会话标题、路由句柄或准入。留空并保存可清除。'; box.appendChild(note)
+  const select = document.createElement('select'); select.setAttribute('aria-label', '选择命名的本机会话')
+  for (const id of new Set([...sessions.map(row => row.id), ...Object.keys(names)])) {
+    const row = sessions.find(row => row.id === id), option = document.createElement('option')
+    option.value = id; option.textContent = (names[id] ?? row?.name ?? row?.label ?? id) + ' · ' + id; select.appendChild(option)
+  }
+  const input = document.createElement('input'); input.type = 'text'; input.maxLength = 64; input.setAttribute('aria-label', '人工席位名'); input.placeholder = '例如：开发席'
+  const button = document.createElement('button'); button.type = 'submit'; button.textContent = '保存席位名'; button.className = 'wb-member-submit'
+  const form = document.createElement('form'); form.className = 'wb-member-add'; form.append(select, input, button)
+  const status = document.createElement('p'); status.className = 'wb-hint'; status.setAttribute('role', 'status'); status.setAttribute('aria-live', 'polite')
+  let pending = false
+  const load = () => { input.value = names[select.value] ?? ''; button.disabled = pending || select.value === '' }
+  select.addEventListener('change', load); load()
+  form.addEventListener('submit', async event => {
+    event.preventDefault(); if (pending || select.value === '') return
+    const id = select.value, value = input.value.trim(), next = { ...names }
+    if (value === '') delete next[id]; else next[id] = value
+    pending = true; button.disabled = true; select.disabled = true; input.disabled = true
+    try {
+      const result = await save(next)
+      if (result.ok) { delete names[id]; if (value !== '') names[id] = value; status.textContent = '席位名已保存；目录将随状态刷新。' }
+      else status.textContent = result.error ?? '保存失败'
+    } catch (error) { status.textContent = '保存失败：' + String(error) }
+    finally { pending = false; select.disabled = false; input.disabled = false; load() }
+  })
+  box.append(form, status); return box
+}

package/nexus-stage/src/session-drag.ts

@@ -1,64 +1,64 @@
-/**
- * Drag a local session from the workbench rail (目录 · 本机会话) straight into
- * a canvas team frame on the board (owner request 2026-11-04). The rail row
- * carries the session id in a private drag type; the board accepts it only
- * over a frame and turns the drop into the same add-member action a card drop
- * makes, so roster frames, mirror frames (fleet relay) and the host's own
- * refusals all behave exactly as for an on-board drag.
- * @module nexus-stage/session-drag
- */
-
-/** Private drag type: an arbitrary page or file dropped on the board is ignored. */
-export const SESSION_DRAG_TYPE = 'application/x-dsh-session'
-
-/** Make one rail row draggable as a local session. */
-export function makeSessionDraggable(item: HTMLElement, sessionId: string): void {
-  item.draggable = true
-  item.classList.add('is-draggable')
-  item.title = `${item.title === '' ? sessionId : item.title} · 可拖入画布队`
-  item.addEventListener('dragstart', ev => {
-    if (ev.dataTransfer === null) return
-    ev.dataTransfer.setData(SESSION_DRAG_TYPE, sessionId)
-    ev.dataTransfer.effectAllowed = 'copy'
-  })
-}
-
-export interface SessionDropDeps {
-  /** The innermost team frame under a client point, if any. */
-  frameAt(clientX: number, clientY: number): string | undefined
-  /** Frame elements by team name, for the drop-target highlight. */
-  frames(): ReadonlyMap<string, HTMLElement>
-  /** A session dropped on a frame. */
-  drop(team: string, sessionId: string): void
-  readonly signal: AddEventListenerOptions
-}
-
-/** Accept rail session drags on the board root. */
-export function attachSessionDrop(root: HTMLElement, d: SessionDropDeps): void {
-  const carries = (ev: DragEvent): boolean => ev.dataTransfer !== null && [...ev.dataTransfer.types].includes(SESSION_DRAG_TYPE)
-  const highlight = (team: string | undefined): void => {
-    for (const [name, el] of d.frames()) el.classList.toggle('drop-target', name === team)
-  }
-  root.addEventListener('dragover', ev => {
-    if (!carries(ev)) return
-    const team = d.frameAt(ev.clientX, ev.clientY)
-    highlight(team)
-    if (team === undefined) return
-    ev.preventDefault() // only a frame is a drop target
-    ev.dataTransfer!.dropEffect = 'copy'
-  }, d.signal)
-  root.addEventListener('dragleave', ev => {
-    if (carries(ev) && (ev.relatedTarget === null || !root.contains(ev.relatedTarget as Node))) highlight(undefined)
-  }, d.signal)
-  // A drag cancelled with Esc over a frame fires no dragleave on the board: the source's dragend clears it.
-  root.ownerDocument.addEventListener('dragend', () => highlight(undefined), d.signal)
-  root.addEventListener('drop', ev => {
-    if (!carries(ev)) return
-    highlight(undefined)
-    const team = d.frameAt(ev.clientX, ev.clientY)
-    const id = ev.dataTransfer!.getData(SESSION_DRAG_TYPE)
-    if (team === undefined || id === '') return
-    ev.preventDefault()
-    d.drop(team, id)
-  }, d.signal)
-}
+/**
+ * Drag a local session from the workbench rail (目录 · 本机会话) straight into
+ * a canvas team frame on the board (owner request 2026-11-04). The rail row
+ * carries the session id in a private drag type; the board accepts it only
+ * over a frame and turns the drop into the same add-member action a card drop
+ * makes, so roster frames, mirror frames (fleet relay) and the host's own
+ * refusals all behave exactly as for an on-board drag.
+ * @module nexus-stage/session-drag
+ */
+
+/** Private drag type: an arbitrary page or file dropped on the board is ignored. */
+export const SESSION_DRAG_TYPE = 'application/x-dsh-session'
+
+/** Make one rail row draggable as a local session. */
+export function makeSessionDraggable(item: HTMLElement, sessionId: string): void {
+  item.draggable = true
+  item.classList.add('is-draggable')
+  item.title = `${item.title === '' ? sessionId : item.title} · 可拖入画布队`
+  item.addEventListener('dragstart', ev => {
+    if (ev.dataTransfer === null) return
+    ev.dataTransfer.setData(SESSION_DRAG_TYPE, sessionId)
+    ev.dataTransfer.effectAllowed = 'copy'
+  })
+}
+
+export interface SessionDropDeps {
+  /** The innermost team frame under a client point, if any. */
+  frameAt(clientX: number, clientY: number): string | undefined
+  /** Frame elements by team name, for the drop-target highlight. */
+  frames(): ReadonlyMap<string, HTMLElement>
+  /** A session dropped on a frame. */
+  drop(team: string, sessionId: string): void
+  readonly signal: AddEventListenerOptions
+}
+
+/** Accept rail session drags on the board root. */
+export function attachSessionDrop(root: HTMLElement, d: SessionDropDeps): void {
+  const carries = (ev: DragEvent): boolean => ev.dataTransfer !== null && [...ev.dataTransfer.types].includes(SESSION_DRAG_TYPE)
+  const highlight = (team: string | undefined): void => {
+    for (const [name, el] of d.frames()) el.classList.toggle('drop-target', name === team)
+  }
+  root.addEventListener('dragover', ev => {
+    if (!carries(ev)) return
+    const team = d.frameAt(ev.clientX, ev.clientY)
+    highlight(team)
+    if (team === undefined) return
+    ev.preventDefault() // only a frame is a drop target
+    ev.dataTransfer!.dropEffect = 'copy'
+  }, d.signal)
+  root.addEventListener('dragleave', ev => {
+    if (carries(ev) && (ev.relatedTarget === null || !root.contains(ev.relatedTarget as Node))) highlight(undefined)
+  }, d.signal)
+  // A drag cancelled with Esc over a frame fires no dragleave on the board: the source's dragend clears it.
+  root.ownerDocument.addEventListener('dragend', () => highlight(undefined), d.signal)
+  root.addEventListener('drop', ev => {
+    if (!carries(ev)) return
+    highlight(undefined)
+    const team = d.frameAt(ev.clientX, ev.clientY)
+    const id = ev.dataTransfer!.getData(SESSION_DRAG_TYPE)
+    if (team === undefined || id === '') return
+    ev.preventDefault()
+    d.drop(team, id)
+  }, d.signal)
+}

package/nexus-stage/src/viewport.ts

@@ -1,106 +1,106 @@
-/**
- * Viewport math for the 2D planning canvas: pan/zoom state with the same
- * clamp contract as the persisted layout (scale 0.25-3, coordinates
- * bounded), pointer-anchored zoom, and the CSS transform that carries the
- * world container. Pure functions throughout - the DOM layer applies the
- * returned transform, it never computes one.
- *
- * Convention (shared with the host LayoutStore): (x, y) is the world
- * point displayed at the viewport's top-left corner; scale multiplies
- * world units into screen pixels.
- * @module nexus-stage/viewport
- */
-
-import { SCALE_MAX, SCALE_MIN, type LayoutViewport } from './layout-doc'
-
-/** Re-export for callers that only want the viewport vocabulary. */
-export type { LayoutViewport, LayoutViewport as ViewportState } from './layout-doc'
-
-/** The zero viewport: origin, unzoomed - what a fresh canvas shows. */
-export const IDENTITY_VIEWPORT: LayoutViewport = { x: 0, y: 0, scale: 1 }
-
-function clampScale(scale: number): number {
-  return Math.max(SCALE_MIN, Math.min(SCALE_MAX, scale))
-}
-
-/** Clamp an untrusted viewport into the persisted-layout envelope. */
-export function clampViewport(vp: LayoutViewport): LayoutViewport {
-  const safe = Number.isFinite(vp.scale) ? vp.scale : 1
-  const x = Number.isFinite(vp.x) ? vp.x : 0
-  const y = Number.isFinite(vp.y) ? vp.y : 0
-  return { x, y, scale: clampScale(safe) }
-}
-
-/** Screen (client-relative px) -> world point. */
-export function screenToWorld(vp: LayoutViewport, sx: number, sy: number): { x: number; y: number } {
-  return { x: vp.x + sx / vp.scale, y: vp.y + sy / vp.scale }
-}
-
-/** World point -> screen (client-relative px). */
-export function worldToScreen(vp: LayoutViewport, wx: number, wy: number): { x: number; y: number } {
-  return { x: (wx - vp.x) * vp.scale, y: (wy - vp.y) * vp.scale }
-}
-
-/** Pan by screen-space pixels; dividing by scale keeps 1px = 1px on screen. */
-export function panBy(vp: LayoutViewport, dx: number, dy: number): LayoutViewport {
-  return { x: vp.x + dx / vp.scale, y: vp.y + dy / vp.scale, scale: vp.scale }
-}
-
-/**
- * Zoom by a multiplicative factor keeping the world point under the
- * anchor screen position (ax, ay) fixed: the card under the cursor stays
- * under the cursor. Invariant: vp' = vp + a/s - a/s'.
- */
-export function zoomAt(vp: LayoutViewport, factor: number, ax: number, ay: number): LayoutViewport {
-  const scale = clampScale(vp.scale * factor)
-  if (scale === vp.scale) return vp
-  return { x: vp.x + ax / vp.scale - ax / scale, y: vp.y + ay / vp.scale - ay / scale, scale }
-}
-
-/** Content bounds in world space (null = nothing to fit). */
-export interface WorldBounds { readonly minX: number; readonly minY: number; readonly maxX: number; readonly maxY: number }
-
-/** A fit never shrinks past a readable floor: below {@link NARROW_FIT_WIDTH}
- *  (the board's phone breakpoint) {@link NARROW_FIT_FLOOR}, at any wider
- *  viewport {@link WIDE_FIT_FLOOR}. Fitting a whole board drew 13px card
- *  names at ~7px on a phone, and a real 66-card board at 30% on a desktop
- *  (review 2026-10-27, real-host check). Past the floor the fit anchors the
- *  content's top-left corner instead of its centre; the rest is a pan away. */
-export const NARROW_FIT_WIDTH = 680
-export const NARROW_FIT_FLOOR = 0.8
-export const WIDE_FIT_FLOOR = 0.6
-const FIT_MARGIN = 16
-
-/**
- * Fit the content bounds into a viewW x viewH viewport at 90% fill,
- * clamped to the persisted scale envelope; empty bounds reset to identity.
- * The scale is floored (see {@link WIDE_FIT_FLOOR}); an explicit maxScale
- * below the floor still wins.
- */
-export function fitView(bounds: WorldBounds | null, viewW: number, viewH: number, maxScale = Number.POSITIVE_INFINITY): LayoutViewport {
-  if (bounds === null || viewW <= 0 || viewH <= 0) return IDENTITY_VIEWPORT
-  const bw = bounds.maxX - bounds.minX
-  const bh = bounds.maxY - bounds.minY
-  if (!(bw > 0) || !(bh > 0)) return IDENTITY_VIEWPORT
-  // The floor is about content that does not FIT at a readable scale, so it
-  // is judged on the natural fit — a caller's maxScale cap below the floor
-  // must not turn a board that fits into a top-left-anchored one (PR #79 review).
-  const natural = 0.9 * Math.min(viewW / bw, viewH / bh)
-  const fitted = Math.min(maxScale, natural)
-  const floor = viewW < NARROW_FIT_WIDTH ? NARROW_FIT_FLOOR : WIDE_FIT_FLOOR
-  if (natural < floor) {
-    const scale = clampScale(Math.min(maxScale, floor))
-    return { x: bounds.minX - FIT_MARGIN / scale, y: bounds.minY - FIT_MARGIN / scale, scale }
-  }
-  const scale = clampScale(fitted)
-  return {
-    x: (bounds.minX + bounds.maxX) / 2 - viewW / (2 * scale),
-    y: (bounds.minY + bounds.maxY) / 2 - viewH / (2 * scale),
-    scale,
-  }
-}
-
-/** The CSS transform for the world container: translate then scale. */
-export function worldTransformCss(vp: LayoutViewport): string {
-  return `translate(${-vp.x * vp.scale}px, ${-vp.y * vp.scale}px) scale(${vp.scale})`
-}
+/**
+ * Viewport math for the 2D planning canvas: pan/zoom state with the same
+ * clamp contract as the persisted layout (scale 0.25-3, coordinates
+ * bounded), pointer-anchored zoom, and the CSS transform that carries the
+ * world container. Pure functions throughout - the DOM layer applies the
+ * returned transform, it never computes one.
+ *
+ * Convention (shared with the host LayoutStore): (x, y) is the world
+ * point displayed at the viewport's top-left corner; scale multiplies
+ * world units into screen pixels.
+ * @module nexus-stage/viewport
+ */
+
+import { SCALE_MAX, SCALE_MIN, type LayoutViewport } from './layout-doc'
+
+/** Re-export for callers that only want the viewport vocabulary. */
+export type { LayoutViewport, LayoutViewport as ViewportState } from './layout-doc'
+
+/** The zero viewport: origin, unzoomed - what a fresh canvas shows. */
+export const IDENTITY_VIEWPORT: LayoutViewport = { x: 0, y: 0, scale: 1 }
+
+function clampScale(scale: number): number {
+  return Math.max(SCALE_MIN, Math.min(SCALE_MAX, scale))
+}
+
+/** Clamp an untrusted viewport into the persisted-layout envelope. */
+export function clampViewport(vp: LayoutViewport): LayoutViewport {
+  const safe = Number.isFinite(vp.scale) ? vp.scale : 1
+  const x = Number.isFinite(vp.x) ? vp.x : 0
+  const y = Number.isFinite(vp.y) ? vp.y : 0
+  return { x, y, scale: clampScale(safe) }
+}
+
+/** Screen (client-relative px) -> world point. */
+export function screenToWorld(vp: LayoutViewport, sx: number, sy: number): { x: number; y: number } {
+  return { x: vp.x + sx / vp.scale, y: vp.y + sy / vp.scale }
+}
+
+/** World point -> screen (client-relative px). */
+export function worldToScreen(vp: LayoutViewport, wx: number, wy: number): { x: number; y: number } {
+  return { x: (wx - vp.x) * vp.scale, y: (wy - vp.y) * vp.scale }
+}
+
+/** Pan by screen-space pixels; dividing by scale keeps 1px = 1px on screen. */
+export function panBy(vp: LayoutViewport, dx: number, dy: number): LayoutViewport {
+  return { x: vp.x + dx / vp.scale, y: vp.y + dy / vp.scale, scale: vp.scale }
+}
+
+/**
+ * Zoom by a multiplicative factor keeping the world point under the
+ * anchor screen position (ax, ay) fixed: the card under the cursor stays
+ * under the cursor. Invariant: vp' = vp + a/s - a/s'.
+ */
+export function zoomAt(vp: LayoutViewport, factor: number, ax: number, ay: number): LayoutViewport {
+  const scale = clampScale(vp.scale * factor)
+  if (scale === vp.scale) return vp
+  return { x: vp.x + ax / vp.scale - ax / scale, y: vp.y + ay / vp.scale - ay / scale, scale }
+}
+
+/** Content bounds in world space (null = nothing to fit). */
+export interface WorldBounds { readonly minX: number; readonly minY: number; readonly maxX: number; readonly maxY: number }
+
+/** A fit never shrinks past a readable floor: below {@link NARROW_FIT_WIDTH}
+ *  (the board's phone breakpoint) {@link NARROW_FIT_FLOOR}, at any wider
+ *  viewport {@link WIDE_FIT_FLOOR}. Fitting a whole board drew 13px card
+ *  names at ~7px on a phone, and a real 66-card board at 30% on a desktop
+ *  (review 2026-10-27, real-host check). Past the floor the fit anchors the
+ *  content's top-left corner instead of its centre; the rest is a pan away. */
+export const NARROW_FIT_WIDTH = 680
+export const NARROW_FIT_FLOOR = 0.8
+export const WIDE_FIT_FLOOR = 0.6
+const FIT_MARGIN = 16
+
+/**
+ * Fit the content bounds into a viewW x viewH viewport at 90% fill,
+ * clamped to the persisted scale envelope; empty bounds reset to identity.
+ * The scale is floored (see {@link WIDE_FIT_FLOOR}); an explicit maxScale
+ * below the floor still wins.
+ */
+export function fitView(bounds: WorldBounds | null, viewW: number, viewH: number, maxScale = Number.POSITIVE_INFINITY): LayoutViewport {
+  if (bounds === null || viewW <= 0 || viewH <= 0) return IDENTITY_VIEWPORT
+  const bw = bounds.maxX - bounds.minX
+  const bh = bounds.maxY - bounds.minY
+  if (!(bw > 0) || !(bh > 0)) return IDENTITY_VIEWPORT
+  // The floor is about content that does not FIT at a readable scale, so it
+  // is judged on the natural fit — a caller's maxScale cap below the floor
+  // must not turn a board that fits into a top-left-anchored one (PR #79 review).
+  const natural = 0.9 * Math.min(viewW / bw, viewH / bh)
+  const fitted = Math.min(maxScale, natural)
+  const floor = viewW < NARROW_FIT_WIDTH ? NARROW_FIT_FLOOR : WIDE_FIT_FLOOR
+  if (natural < floor) {
+    const scale = clampScale(Math.min(maxScale, floor))
+    return { x: bounds.minX - FIT_MARGIN / scale, y: bounds.minY - FIT_MARGIN / scale, scale }
+  }
+  const scale = clampScale(fitted)
+  return {
+    x: (bounds.minX + bounds.maxX) / 2 - viewW / (2 * scale),
+    y: (bounds.minY + bounds.maxY) / 2 - viewH / (2 * scale),
+    scale,
+  }
+}
+
+/** The CSS transform for the world container: translate then scale. */
+export function worldTransformCss(vp: LayoutViewport): string {
+  return `translate(${-vp.x * vp.scale}px, ${-vp.y * vp.scale}px) scale(${vp.scale})`
+}