@world-engines/project-host 0.1.0-alpha.0

package/assets/gui/workspace-status.js

@@ -0,0 +1,255 @@
+const SVG_NS = "http://www.w3.org/2000/svg";
+const STYLE_MARKER = "data-workspace-status-styles";
+const MAX_DETAIL_LENGTH = 240;
+
+const SURFACES = {
+  graph: {
+    name: "世界图",
+    loadingTitle: "正在载入世界图",
+    loadingDescription: "正在整理人物、地点与关系，请稍候。",
+  },
+  map: {
+    name: "世界地图",
+    loadingTitle: "正在载入世界地图",
+    loadingDescription: "正在读取地形、水系与地图标记，请稍候。",
+  },
+  trigger: {
+    name: "触发器",
+    loadingTitle: "正在载入触发器",
+    loadingDescription: "正在准备触发条件与动作流程，请稍候。",
+  },
+};
+
+const ERROR_COPY = {
+  session: {
+    title: "连接已过期",
+    description: "当前编辑连接已失效。刷新连接后再继续，未提交的操作不会自动重放。",
+    retryLabel: "刷新连接",
+  },
+  network: {
+    title: "暂时无法连接",
+    description: "服务暂时不可达，请检查网络后重试。",
+    retryLabel: "重新连接",
+  },
+  conflict: {
+    title: "内容版本已更新",
+    description: "其他修改已先一步保存。重新读取最新内容后再继续。",
+    retryLabel: "重新读取",
+  },
+  validation: {
+    title: "内容需要检查",
+    description: "部分数据不符合当前规则。请返回检查后再次提交。",
+    retryLabel: "返回检查",
+  },
+  worker: {
+    title: "生成服务暂不可用",
+    description: "后台生成任务没有完成。当前内容仍会保留，可以稍后重试。",
+    retryLabel: "重新生成",
+  },
+  unknown: {
+    title: "暂时无法显示",
+    description: "遇到了未预期的问题。当前内容仍会保留，请重试。",
+    retryLabel: "重试",
+  },
+};
+
+const ILLUSTRATIONS = {
+  "graph-loading": [
+    ["path", { d: "M20 32 38 20l20 12 18-13 20 13M38 20v37m20-25v31m18-44v39" }],
+    ["circle", { cx: "20", cy: "32", r: "6" }],
+    ["circle", { cx: "38", cy: "20", r: "6" }],
+    ["circle", { cx: "58", cy: "32", r: "6" }],
+    ["circle", { cx: "76", cy: "19", r: "6" }],
+    ["circle", { cx: "96", cy: "32", r: "6" }],
+    ["circle", { cx: "38", cy: "57", r: "6" }],
+    ["circle", { cx: "58", cy: "63", r: "6" }],
+    ["circle", { cx: "76", cy: "58", r: "6" }],
+  ],
+  "map-loading": [
+    ["path", { d: "M13 65c13-10 19-5 29-16s17-27 30-25 15 19 35 36M14 72c18-8 31-5 45-17 15-13 28-15 47-5" }],
+    ["path", { d: "M31 51c9 0 13 5 19 13s10 11 18 12 15-4 20-13" }],
+    ["circle", { cx: "72", cy: "24", r: "4" }],
+  ],
+  "trigger-loading": [
+    ["rect", { x: "12", y: "25", width: "25", height: "18", rx: "4" }],
+    ["path", { d: "M37 34h15l8-10 16 20 9-10h21M60 24v-9m0 38v-9" }],
+    ["rect", { x: "84", y: "25", width: "24", height: "18", rx: "4" }],
+    ["circle", { cx: "60", cy: "15", r: "4" }],
+    ["circle", { cx: "60", cy: "53", r: "4" }],
+  ],
+  "session-lock": [
+    ["rect", { x: "34", y: "35", width: "52", height: "37", rx: "7" }],
+    ["path", { d: "M45 35v-9a15 15 0 0 1 30 0v9M60 49v10" }],
+    ["circle", { cx: "60", cy: "48", r: "3" }],
+    ["path", { d: "M21 55h9m60 0h9" }],
+  ],
+  "network-disconnected": [
+    ["path", { d: "M18 35h22l10 10m20 20 10 10h22M40 29v12m40 28v12M47 55H26m47 0h21" }],
+    ["circle", { cx: "20", cy: "55", r: "6" }],
+    ["circle", { cx: "100", cy: "55", r: "6" }],
+    ["path", { d: "m46 27 28 56" }],
+  ],
+  "revision-branch": [
+    ["path", { d: "M34 20v26a16 16 0 0 0 16 16h36M34 46a16 16 0 0 1 16-16h22" }],
+    ["circle", { cx: "34", cy: "20", r: "6" }],
+    ["circle", { cx: "72", cy: "30", r: "6" }],
+    ["circle", { cx: "86", cy: "62", r: "6" }],
+  ],
+  "document-warning": [
+    ["path", { d: "M33 15h37l17 17v52H33zM70 15v18h17" }],
+    ["path", { d: "M60 42v19" }],
+    ["circle", { cx: "60", cy: "72", r: "3" }],
+  ],
+  "terrain-worker": [
+    ["path", { d: "M12 76c15-18 24-24 35-13l12-20 21 25 12-11 16 19M76 23a10 10 0 1 1-20 0 10 10 0 0 1 20 0M66 8v5m0 20v5M51 23h5m20 0h5m-5-10-4 4m-12 12-4 4m20 0-4-4M60 17l-4-4" }],
+  ],
+  warning: [
+    ["path", { d: "M60 14 106 82H14z" }],
+    ["path", { d: "M60 38v21" }],
+    ["circle", { cx: "60", cy: "70", r: "3" }],
+  ],
+};
+
+function ensureStylesheet() {
+  if (typeof document === "undefined" || !document.head) return;
+  if (document.head.querySelector(`link[${STYLE_MARKER}="true"]`)) return;
+  const link = document.createElement("link");
+  link.rel = "stylesheet";
+  link.href = new URL("./workspace-status.css", import.meta.url).href;
+  link.setAttribute(STYLE_MARKER, "true");
+  document.head.append(link);
+}
+
+function element(tag, className, text) {
+  const node = document.createElement(tag);
+  if (className) node.className = className;
+  if (text !== undefined) node.textContent = text;
+  return node;
+}
+
+function illustration(name) {
+  const svg = document.createElementNS(SVG_NS, "svg");
+  svg.setAttribute("viewBox", "0 0 120 96");
+  svg.setAttribute("aria-hidden", "true");
+  svg.setAttribute("focusable", "false");
+  svg.setAttribute("data-illustration", name);
+  for (const [tag, attributes] of ILLUSTRATIONS[name] ?? ILLUSTRATIONS.warning) {
+    const child = document.createElementNS(SVG_NS, tag);
+    for (const [key, value] of Object.entries(attributes)) child.setAttribute(key, value);
+    svg.append(child);
+  }
+  return svg;
+}
+
+function errorFields(error) {
+  if (typeof error === "string") return { code: "", message: error };
+  if (!error || typeof error !== "object") return { code: "", message: "" };
+  return {
+    code: typeof error.code === "string" ? error.code : "",
+    message: typeof error.message === "string" ? error.message : "",
+  };
+}
+
+function classifyError(error) {
+  const { code, message } = errorFields(error);
+  const signal = `${code} ${message}`.toUpperCase();
+  if (/GUI_SESSION_REQUIRED|SESSION_REQUIRED|UNAUTHORIZED|AUTH(?:ENTICATION)?|会话.{0,8}(过期|失效)|登录.{0,8}(过期|失效)/u.test(signal)) return "session";
+  if (/NETWORK|OFFLINE|ECONN|FETCH|SOCKET|网络|连接失败|无法连接/u.test(signal)) return "network";
+  if (/STALE|REVISION|CONFLICT|\bCAS\b|版本.{0,8}(变化|冲突|更新)|冲突/u.test(signal)) return "conflict";
+  if (/VALIDATION|SCHEMA|INVALID|校验|验证|格式|字段/u.test(signal)) return "validation";
+  if (/GENERATOR|WORKER|WASM|生成器|后台生成|生成失败/u.test(signal)) return "worker";
+  return "unknown";
+}
+
+function safeCode(value) {
+  return /^[A-Z][A-Z0-9_.:-]{0,79}$/u.test(value) ? value : "";
+}
+
+function safeMessage(value) {
+  if (!value) return "";
+  let message = String(value).split(/\r?\n/u, 1)[0];
+  message = message
+    .replace(/(["'](?:authorization|token|access[_-]?token|refresh[_-]?token|api[_-]?key|secret|password|credential)s?["']\s*:\s*["'])(?:bearer\s+)?[^"']*(["'])/giu, "$1[已隐藏]$2")
+    .replace(/(\b(?:authorization|token|access[_-]?token|refresh[_-]?token|api[_-]?key|secret|password|credential)s?\b\s*[:=]\s*)(?:bearer\s+)?[^\s,;]+/giu, "$1[已隐藏]")
+    .replace(/(\bbearer\s+)[^\s,;]+/giu, "$1[已隐藏]")
+    .replace(/([?&](?:token|access_token|refresh_token|api_key|key|secret|password)=)[^&#\s]+/giu, "$1[已隐藏]");
+  return message.length > MAX_DETAIL_LENGTH ? `${message.slice(0, MAX_DETAIL_LENGTH - 1)}…` : message;
+}
+
+function technicalDetails(error) {
+  const fields = errorFields(error);
+  const code = safeCode(fields.code);
+  const message = safeMessage(fields.message);
+  if (!code && !message) return null;
+  const details = element("details", "workspace-status__details");
+  details.append(element("summary", "", "技术详情"));
+  const content = element("div", "workspace-status__details-content");
+  if (code) content.append(element("code", "workspace-status__code", code));
+  if (message) content.append(element("p", "workspace-status__message", message));
+  details.append(content);
+  return details;
+}
+
+function loadingView(surface) {
+  const copy = SURFACES[surface];
+  const root = element("section", "workspace-status workspace-status--loading");
+  root.dataset.surface = surface;
+  root.setAttribute("role", "status");
+  root.setAttribute("aria-live", "polite");
+  root.append(illustration(`${surface}-loading`));
+  root.append(element("h2", "workspace-status__title", copy.loadingTitle));
+  root.append(element("p", "workspace-status__description", copy.loadingDescription));
+  return root;
+}
+
+function errorView(surface, error, onRetry, retryLabel) {
+  const kind = classifyError(error);
+  const copy = ERROR_COPY[kind];
+  const illustrationName = {
+    session: "session-lock",
+    network: "network-disconnected",
+    conflict: "revision-branch",
+    validation: "document-warning",
+    worker: "terrain-worker",
+    unknown: "warning",
+  }[kind];
+  const root = element("section", "workspace-status workspace-status--error");
+  root.dataset.surface = surface;
+  root.dataset.errorKind = kind;
+  root.setAttribute("role", "alert");
+  root.append(illustration(illustrationName));
+  root.append(element("h2", "workspace-status__title", copy.title));
+  const description = kind === "unknown"
+    ? `${SURFACES[surface].name}暂时无法显示。请重试，未提交的操作不会自动执行。`
+    : copy.description;
+  root.append(element("p", "workspace-status__description", description));
+  const details = technicalDetails(error);
+  if (details) root.append(details);
+  const button = element("button", "button primary workspace-status__action", kind === "session" ? copy.retryLabel : (retryLabel || copy.retryLabel));
+  button.type = "button";
+  if (kind === "session") {
+    button.addEventListener("click", () => globalThis.location?.reload());
+  } else if (typeof onRetry === "function") {
+    button.addEventListener("click", () => onRetry());
+  } else {
+    button.disabled = true;
+  }
+  root.append(button);
+  return root;
+}
+
+/**
+ * 在世界图、世界地图或触发器工作区渲染统一的载入/错误状态。
+ * 会话错误只允许用户主动刷新页面；其他恢复动作由调用方提供 onRetry。
+ */
+export function renderWorkspaceStatus(target, options = {}) {
+  if (!target || typeof target.replaceChildren !== "function") throw new TypeError("target 必须是可替换子节点的 DOM 元素");
+  const state = options.state === "error" ? "error" : "loading";
+  const surface = Object.hasOwn(SURFACES, options.surface) ? options.surface : "graph";
+  ensureStylesheet();
+  const view = state === "error"
+    ? errorView(surface, options.error, options.onRetry, options.retryLabel)
+    : loadingView(surface);
+  target.replaceChildren(view);
+  return view;
+}

package/assets/gui/world-map-globe.js

@@ -0,0 +1,187 @@
+const TAU = Math.PI * 2;
+const BASE_RADIUS_RATIO = 0.46;
+const MAX_RENDER_EDGE = 600;
+const renderSurfaces = new WeakMap();
+
+function finite(value, name) {
+  if (typeof value !== "number" || !Number.isFinite(value)) throw new TypeError(`${name} 必须是有限数值`);
+  return value;
+}
+
+function geometry(viewport, view) {
+  const width = finite(viewport?.width, "viewport.width");
+  const height = finite(viewport?.height, "viewport.height");
+  const yaw = finite(view?.yaw, "view.yaw");
+  const pitch = finite(view?.pitch, "view.pitch");
+  const zoom = finite(view?.zoom, "view.zoom");
+  if (width <= 0 || height <= 0) throw new RangeError("viewport 尺寸必须大于零");
+  if (zoom <= 0) throw new RangeError("view.zoom 必须大于零");
+  return {
+    width,
+    height,
+    centerX: width / 2,
+    centerY: height / 2,
+    radius: Math.min(width, height) * BASE_RADIUS_RATIO * zoom,
+    sinYaw: Math.sin(yaw),
+    cosYaw: Math.cos(yaw),
+    sinPitch: Math.sin(pitch),
+    cosPitch: Math.cos(pitch),
+  };
+}
+
+function normalizedU(value) {
+  const result = value - Math.floor(value);
+  return result === 1 ? 0 : result;
+}
+
+/**
+ * 把等距圆柱纹理坐标投影为 CSS 像素坐标。
+ * yaw 与 pitch 的单位为弧度；u=0/1 是国际日期变更线，v=0 是北极。
+ */
+export function projectGlobe(u, v, viewport, view) {
+  finite(u, "u");
+  finite(v, "v");
+  const g = geometry(viewport, view);
+  const longitude = (normalizedU(u) - 0.5) * TAU;
+  const latitude = (0.5 - v) * Math.PI;
+  const cosLatitude = Math.cos(latitude);
+  const worldX = Math.sin(longitude) * cosLatitude;
+  const worldY = Math.sin(latitude);
+  const worldZ = Math.cos(longitude) * cosLatitude;
+
+  const cameraX = g.cosYaw * worldX - g.sinYaw * worldZ;
+  const yawZ = g.sinYaw * worldX + g.cosYaw * worldZ;
+  const cameraY = g.cosPitch * worldY - g.sinPitch * yawZ;
+  const cameraZ = g.sinPitch * worldY + g.cosPitch * yawZ;
+  return {
+    x: g.centerX + cameraX * g.radius,
+    y: g.centerY - cameraY * g.radius,
+    visible: cameraZ >= 0,
+  };
+}
+
+/** 把 CSS 像素坐标反投影为球面经纬度；球外与背半球没有命中。 */
+export function pickGlobe(x, y, viewport, view) {
+  finite(x, "x");
+  finite(y, "y");
+  const g = geometry(viewport, view);
+  const cameraX = (x - g.centerX) / g.radius;
+  const cameraY = (g.centerY - y) / g.radius;
+  const radialSquared = cameraX * cameraX + cameraY * cameraY;
+  if (radialSquared > 1 + 1e-12) return null;
+
+  // 正交投影的屏幕点只取朝向相机的半球，因此不会点中背面。
+  const cameraZ = Math.sqrt(Math.max(0, 1 - radialSquared));
+  const worldY = g.cosPitch * cameraY + g.sinPitch * cameraZ;
+  const yawZ = -g.sinPitch * cameraY + g.cosPitch * cameraZ;
+  const worldX = g.cosYaw * cameraX + g.sinYaw * yawZ;
+  const worldZ = -g.sinYaw * cameraX + g.cosYaw * yawZ;
+  let longitudeRadians = Math.atan2(worldX, worldZ);
+  if (longitudeRadians >= Math.PI) longitudeRadians -= TAU;
+  const latitudeRadians = Math.asin(Math.max(-1, Math.min(1, worldY)));
+  const u = normalizedU(longitudeRadians / TAU + 0.5);
+  const v = Math.max(0, Math.min(1, 0.5 - latitudeRadians / Math.PI));
+  return {
+    u,
+    v,
+    longitude: longitudeRadians * 180 / Math.PI,
+    latitude: latitudeRadians * 180 / Math.PI,
+  };
+}
+
+function createSurface(ctx, width, height) {
+  let surface = renderSurfaces.get(ctx);
+  if (!surface) {
+    const ownerDocument = ctx.canvas?.ownerDocument ?? globalThis.document;
+    const canvas = typeof OffscreenCanvas === "function"
+      ? new OffscreenCanvas(width, height)
+      : ownerDocument?.createElement?.("canvas");
+    const surfaceContext = canvas?.getContext?.("2d", { alpha: true });
+    if (!canvas || !surfaceContext) throw new Error("浏览器不支持球面地图离屏画布");
+    surface = { canvas, context: surfaceContext, image: null };
+    renderSurfaces.set(ctx, surface);
+  }
+  if (surface.canvas.width !== width) surface.canvas.width = width;
+  if (surface.canvas.height !== height) surface.canvas.height = height;
+  if (!surface.image || surface.image.width !== width || surface.image.height !== height) {
+    surface.image = surface.context.createImageData(width, height);
+  }
+  return surface;
+}
+
+function validateTexture(texture) {
+  const width = finite(texture?.width, "texture.width");
+  const height = finite(texture?.height, "texture.height");
+  if (!Number.isInteger(width) || !Number.isInteger(height) || width <= 0 || height <= 0) throw new RangeError("texture 尺寸无效");
+  if (!(texture.data instanceof Uint8ClampedArray) || texture.data.length !== width * height * 4) {
+    throw new TypeError("texture.data 必须是匹配尺寸的 Uint8ClampedArray RGBA 数据");
+  }
+  return { data: texture.data, width, height };
+}
+
+/**
+ * 用正交球面投影绘制 RGBA 等距圆柱纹理。球外保持透明，调用方的 CSS 背景会自然透出。
+ */
+export function drawGlobe(ctx, texture, viewport, view) {
+  if (!ctx || typeof ctx.drawImage !== "function") throw new TypeError("ctx 必须是 CanvasRenderingContext2D");
+  const source = validateTexture(texture);
+  const target = geometry(viewport, view);
+  const renderScale = Math.min(1, MAX_RENDER_EDGE / Math.max(target.width, target.height));
+  const renderWidth = Math.max(1, Math.round(target.width * renderScale));
+  const renderHeight = Math.max(1, Math.round(target.height * renderScale));
+  const surface = createSurface(ctx, renderWidth, renderHeight);
+  const image = surface.image;
+  const pixels = image.data;
+  pixels.fill(0);
+
+  const centerX = renderWidth / 2;
+  const centerY = renderHeight / 2;
+  const radius = target.radius * renderScale;
+  const inverseRadius = 1 / radius;
+  const minX = Math.max(0, Math.floor(centerX - radius));
+  const maxX = Math.min(renderWidth - 1, Math.ceil(centerX + radius));
+  const minY = Math.max(0, Math.floor(centerY - radius));
+  const maxY = Math.min(renderHeight - 1, Math.ceil(centerY + radius));
+  const lightX = -0.38;
+  const lightY = 0.5;
+  const lightZ = 0.78;
+
+  for (let outputY = minY; outputY <= maxY; outputY += 1) {
+    const cameraY = (centerY - outputY - 0.5) * inverseRadius;
+    for (let outputX = minX; outputX <= maxX; outputX += 1) {
+      const cameraX = (outputX + 0.5 - centerX) * inverseRadius;
+      const radialSquared = cameraX * cameraX + cameraY * cameraY;
+      if (radialSquared > 1) continue;
+      const cameraZ = Math.sqrt(1 - radialSquared);
+
+      const worldY = target.cosPitch * cameraY + target.sinPitch * cameraZ;
+      const yawZ = -target.sinPitch * cameraY + target.cosPitch * cameraZ;
+      const worldX = target.cosYaw * cameraX + target.sinYaw * yawZ;
+      const worldZ = -target.sinYaw * cameraX + target.cosYaw * yawZ;
+      const longitude = Math.atan2(worldX, worldZ);
+      const latitude = Math.asin(Math.max(-1, Math.min(1, worldY)));
+      const u = normalizedU(longitude / TAU + 0.5);
+      const v = Math.max(0, Math.min(1, 0.5 - latitude / Math.PI));
+      const sourceX = Math.min(source.width - 1, Math.floor(u * source.width));
+      const sourceY = Math.min(source.height - 1, Math.floor(v * source.height));
+      const sourceOffset = (sourceY * source.width + sourceX) * 4;
+      const outputOffset = (outputY * renderWidth + outputX) * 4;
+
+      // 固定在相机空间的日光产生真实球面明暗，同时保留纹理原本的生物群系色彩。
+      const diffuse = Math.max(0, cameraX * lightX + cameraY * lightY + cameraZ * lightZ);
+      const shade = 0.44 + diffuse * 0.56;
+      pixels[outputOffset] = Math.round(source.data[sourceOffset] * shade);
+      pixels[outputOffset + 1] = Math.round(source.data[sourceOffset + 1] * shade);
+      pixels[outputOffset + 2] = Math.round(source.data[sourceOffset + 2] * shade);
+      pixels[outputOffset + 3] = source.data[sourceOffset + 3];
+    }
+  }
+
+  surface.context.putImageData(image, 0, 0);
+  ctx.clearRect?.(0, 0, target.width, target.height);
+  ctx.save?.();
+  ctx.imageSmoothingEnabled = true;
+  ctx.drawImage(surface.canvas, 0, 0, renderWidth, renderHeight, 0, 0, target.width, target.height);
+  ctx.restore?.();
+}
+

package/assets/gui/world-map-worker.js

@@ -0,0 +1,62 @@
+import init, { generate_plane_json, generate_world_roads_json, sample_plane_tile_json } from "./plane-generator.js";
+import { validatePlaneGeneration } from "./plane-generation.js";
+import { validateRoadGeneration } from "./road-generation.js";
+import {
+  PROCEDURAL_GENERATOR_IDENTITY,
+  PROCEDURAL_WORLD_PROFILE,
+  validateProceduralWorld,
+} from "./procedural-city.js";
+
+let wasmReady;
+
+async function loadWasm() {
+  if (!wasmReady) {
+    wasmReady = init({ module_or_path: new URL("./plane-generator_bg.wasm", import.meta.url) });
+  }
+  await wasmReady;
+}
+
+self.addEventListener("message", async (event) => {
+  const id = event.data?.id;
+  if (!Number.isSafeInteger(id) || id < 1) return;
+  const kind = event.data?.kind;
+  const epoch = event.data?.epoch;
+  try {
+    const settings = validatePlaneGeneration(event.data?.settings);
+    if (kind === "roads") {
+      if (!Number.isSafeInteger(epoch) || epoch < 0) throw new TypeError("道路请求 epoch 无效");
+      const roadGeneration = validateRoadGeneration(event.data?.roadGeneration);
+      const world = validateProceduralWorld({
+        profile: PROCEDURAL_WORLD_PROFILE,
+        identity: PROCEDURAL_GENERATOR_IDENTITY,
+        worldSeed: settings.seed,
+        cities: event.data?.cities,
+      }, { widthMeters: settings.widthMeters, heightMeters: settings.heightMeters });
+      await loadWasm();
+      const result = JSON.parse(generate_world_roads_json(JSON.stringify({
+        settings,
+        roadGeneration,
+        cities: world.cities,
+      })));
+      self.postMessage({ id, epoch, kind: "roads", result });
+      return;
+    }
+    await loadWasm();
+    if (kind === "tile") {
+      const tile = event.data?.tile;
+      if (!tile || typeof tile !== "object" || !Number.isInteger(tile.level) || tile.level < 0 || tile.level > 12
+        || !Number.isInteger(tile.x) || tile.x < 0 || tile.x >= 2 ** tile.level
+        || !Number.isInteger(tile.y) || tile.y < 0 || tile.y >= 2 ** tile.level || tile.size !== 128) {
+        throw new TypeError("地图细节区块参数无效");
+      }
+      const result = JSON.parse(sample_plane_tile_json(JSON.stringify({ settings, tile })));
+      self.postMessage({ id, kind: "tile", result });
+      return;
+    }
+    const result = JSON.parse(generate_plane_json(JSON.stringify(settings)));
+    self.postMessage({ id, kind: "base", result });
+  } catch (error) {
+    const responseKind = kind === "roads" || kind === "tile" ? kind : "base";
+    self.postMessage({ id, ...(responseKind === "roads" ? { epoch } : {}), kind: responseKind, error: error instanceof Error ? error.message : "地图生成失败" });
+  }
+});

package/assets/gui/world-map.css

@@ -0,0 +1,30 @@
+body.world-map-active main{height:calc(100vh - 65px);max-width:none;margin:0;padding:0;overflow:hidden}body.world-map-active .world-map-view.active{display:block;height:100%;min-height:0;text-align:initial}.world-map-view>#world-map-root{display:block;height:100%;justify-items:stretch;gap:0;color:inherit}#world-map-root>.world-map-shell{display:grid;height:100%}
+.world-map-shell{height:100%;min-height:520px;display:grid;grid-template-rows:58px minmax(0,1fr);overflow:hidden;background:var(--bg);color:var(--text)}
+.world-map-header{display:flex;align-items:center;gap:18px;padding:0 18px;border-bottom:1px solid var(--line-soft);background:var(--surface)}
+.world-map-heading{min-width:0}.world-map-heading h1{margin:0;font-size:1rem}.world-map-status{margin:2px 0 0;color:var(--muted);font-size:.72rem}.world-map-shell.is-dirty .world-map-status{color:var(--amber)}
+.world-map-header-actions{display:flex;align-items:center;gap:8px;margin-left:auto}.world-map-icon-button{flex:0 0 auto}.world-map-stage{position:relative;min-height:0;overflow:hidden;background:var(--bg)}
+#world-map-root .world-map-icon-button svg{width:100%;height:100%;fill:none;stroke:currentColor;stroke-width:1.7;stroke-linecap:round;stroke-linejoin:round}
+.world-map-canvas{display:block;width:100%;height:100%;min-height:420px;outline:none;cursor:grab;touch-action:none}.world-map-canvas.is-panning{cursor:grabbing}.world-map-canvas:focus-visible{box-shadow:inset 0 0 0 2px var(--accent)}
+.world-map-phase{position:absolute;z-index:3;top:14px;left:50%;transform:translateX(-50%);padding:6px 10px;border:1px solid var(--line-soft);border-radius:999px;background:rgba(32,31,32,.9);color:var(--muted);font-size:.65rem;letter-spacing:.02em;pointer-events:none}
+.world-map-overlay{position:absolute;z-index:5;inset:50% auto auto 50%;transform:translate(-50%,-50%);display:grid;justify-items:center;gap:10px;max-width:min(460px,calc(100% - 40px));padding:14px 18px;border:1px solid var(--line);border-radius:var(--radius);background:rgba(32,31,32,.94);color:var(--muted);font-size:.8rem;text-align:center;box-shadow:var(--shadow);pointer-events:none}.world-map-overlay p{margin:0;white-space:pre-line}.world-map-overlay.has-action{pointer-events:auto}.world-map-overlay.error{border-color:#693b40;color:#ff959a}.world-map-overlay.error .button{color:var(--text)}
+.world-map-preview-watermark{position:absolute;z-index:3;right:14px;top:14px;padding:6px 10px;border:1px solid var(--line-soft);border-radius:999px;background:rgba(32,31,32,.78);color:var(--muted);font-size:.62rem;pointer-events:none}.world-map-shell.is-dirty .world-map-preview-watermark{border-color:var(--amber);color:var(--amber)}
+.world-map-controls{position:absolute;z-index:4;top:14px;left:14px;display:flex;gap:7px;padding:6px;border:1px solid var(--line-soft);border-radius:999px;background:rgba(32,31,32,.92);box-shadow:var(--shadow)}
+.world-map-settings{position:absolute;z-index:4;top:14px;right:14px;width:min(310px,calc(100% - 28px));max-height:calc(100% - 94px);overflow:auto;padding:16px;border:1px solid var(--line);border-radius:var(--radius);background:rgba(32,31,32,.97);box-shadow:var(--shadow)}
+.world-map-settings-heading{display:flex;align-items:baseline;justify-content:space-between;gap:12px;margin-bottom:10px}.world-map-settings-heading h2,.world-map-settings h3{margin:0;font-size:.88rem}.world-map-settings-heading small{color:var(--muted);font-size:.65rem}.world-map-wizard-progress{display:grid;grid-template-columns:1fr 1fr;gap:5px;margin-bottom:13px}.world-map-wizard-progress span{padding:6px 8px;border:1px solid var(--line-soft);border-radius:6px;color:var(--muted);font-size:.64rem;text-align:center}.world-map-wizard-progress span.is-active{border-color:var(--accent);color:var(--text);background:rgba(50,213,81,.08)}.world-map-wizard-progress span.is-complete{color:var(--accent)}.world-map-form{display:grid;grid-template-columns:1fr 1fr;gap:10px}.world-map-field{display:grid;gap:4px;min-width:0}.world-map-field-label{display:flex;justify-content:space-between;gap:7px;color:var(--muted);font-size:.68rem}.world-map-field-label small{font-size:inherit}.world-map-field input,.world-map-field select{min-width:0;width:100%;padding:7px 8px;border:1px solid var(--line);border-radius:6px;background:var(--bg);color:var(--text);font-size:.75rem;outline:none}.world-map-field input:focus,.world-map-field select:focus{border-color:var(--accent);box-shadow:0 0 0 2px rgba(50,213,81,.14)}
+.world-map-settings h3{margin:17px 0 8px;color:var(--muted);font-size:.72rem}.world-map-layers{display:grid;grid-template-columns:1fr 1fr;gap:8px}.world-map-layer{display:flex;align-items:center;gap:7px;color:var(--text);font-size:.72rem;cursor:pointer}.world-map-layer input{width:14px;height:14px;margin:0;accent-color:var(--accent)}
+.world-map-road-hint,.world-map-road-status{margin:0;color:var(--muted);font-size:.68rem;line-height:1.45}.world-map-road-form{display:grid;grid-template-columns:1fr 1fr;gap:10px}.world-map-road-form>.world-map-layer{min-height:28px;padding:0 2px}.world-map-road-actions{display:flex;gap:8px;margin-top:10px}.world-map-road-actions .button{flex:1}.world-map-road-status{min-height:2.9em;margin-top:8px}.world-map-road-status[data-state="loading"]{color:#ffd879}.world-map-road-status[data-state="error"]{color:#ff959a}.world-map-road-status[data-state="ready"]{color:#9ad6a6}
+.world-map-road-parcel-error{margin-top:8px;padding:7px 8px;border:1px solid #693b40;border-radius:6px;background:rgba(105,59,64,.14);color:#ffb0b4;font-size:.67rem}.world-map-road-parcel-error summary{cursor:pointer}.world-map-road-parcel-error pre{max-height:130px;margin:7px 0 0;overflow:auto;white-space:pre-wrap;word-break:break-word;color:#ffd8da;font:inherit}
+.world-map-stats{position:absolute;z-index:3;left:14px;bottom:14px;display:flex;flex-wrap:wrap;gap:0;margin:0;max-width:calc(100% - 28px);border:1px solid var(--line-soft);border-radius:var(--radius);background:rgba(32,31,32,.92);box-shadow:var(--shadow)}.world-map-stat{min-width:92px;padding:8px 11px;border-right:1px solid var(--line-soft)}.world-map-stat:last-child{border-right:0}.world-map-stat dt{color:var(--muted);font-size:.62rem}.world-map-stat dd{margin:1px 0 0;font:650 .7rem/1.35 ui-monospace,SFMono-Regular,Consolas,monospace;white-space:nowrap}
+.world-map-legend{position:absolute;z-index:3;right:14px;bottom:14px;display:flex;flex-wrap:wrap;justify-content:flex-end;gap:8px 10px;max-width:360px;padding:8px 10px;border:1px solid var(--line-soft);border-radius:var(--radius);background:rgba(32,31,32,.92);color:var(--muted);font-size:.62rem}.world-map-legend span{display:flex;align-items:center;gap:4px}.world-map-legend i{width:9px;height:9px;border-radius:2px;background:#316b3b}.world-map-legend i.sea{background:#0e405b}.world-map-legend i.high{background:#987d62}.world-map-legend i.river{background:#1c79a7}.world-map-legend i.lake{background:#166783}.world-map-legend i.object{border:2px solid #f2f2f2;border-radius:50%;background:var(--accent)}
+.world-map-city-legend{position:absolute;z-index:3;right:14px;bottom:58px;display:flex;flex-wrap:wrap;justify-content:flex-end;gap:8px 10px;max-width:360px;padding:8px 10px;border:1px solid var(--line-soft);border-radius:var(--radius);background:rgba(32,31,32,.92);color:var(--muted);font-size:.62rem}.world-map-city-legend[hidden]{display:none}.world-map-city-legend span{display:flex;align-items:center;gap:4px}.world-map-city-legend i{width:9px;height:9px;border-radius:2px}
+.world-map-road-legend{position:absolute;z-index:3;right:14px;bottom:102px;display:flex;flex-wrap:wrap;justify-content:flex-end;gap:8px 10px;max-width:360px;padding:8px 10px;border:1px solid var(--line-soft);border-radius:var(--radius);background:rgba(32,31,32,.92);color:var(--muted);font-size:.62rem}.world-map-road-legend[hidden]{display:none}.world-map-road-legend span{display:flex;align-items:center;gap:4px}.world-map-road-legend i{width:14px;height:0;border-top:2px solid #f2f2f2}.world-map-road-legend i.arterial{border-color:#e0a85d}.world-map-road-legend i.local{border-color:rgba(242,242,242,.75)}.world-map-road-legend i.bridge{border-color:#e9c46a;border-top-style:dashed}.world-map-road-legend i.tunnel{border-color:#b592f5;border-top-style:dashed}
+.world-map-shell:not(.has-map-preview) .world-map-stats,.world-map-shell:not(.has-map-preview) .world-map-legend,.world-map-shell:not(.has-map-preview) .world-map-controls{display:none}
+@media(min-width:851px){.world-map-shell[data-phase="parameters"] .world-map-overlay{inset:50% 338px auto 14px;transform:translateY(-50%);max-width:none}}
+@media(max-width:850px){body.world-map-active main{height:calc(100vh - 121px)}.world-map-header{padding:0 10px}.world-map-heading{display:none}.world-map-header-actions{width:100%;margin:0}.world-map-header-actions .button{flex:1}.world-map-settings{top:64px;max-height:calc(100% - 142px)}.world-map-phase{display:none}.world-map-preview-watermark{top:10px;right:10px}.world-map-stats{right:14px;overflow:auto;flex-wrap:nowrap}.world-map-stat{min-width:88px}.world-map-legend,.world-map-city-legend{display:none}}
+@media(prefers-reduced-motion:reduce){.world-map-canvas{scroll-behavior:auto}}
+.world-map-overlay.is-workspace-status{padding:0;border:0;background:transparent;box-shadow:none;width:min(500px,calc(100% - 36px));pointer-events:auto}.world-map-overlay.is-workspace-status .workspace-status{min-height:0;padding:28px 24px;border:1px solid var(--line-soft);border-radius:var(--radius);background:var(--surface)}
+.world-map-detail-status{position:absolute;z-index:3;top:68px;left:14px;padding:5px 9px;border:1px solid var(--line-soft);border-radius:999px;background:rgba(32,31,32,.88);color:var(--muted);font:600 .62rem/1.2 ui-monospace,SFMono-Regular,Consolas,monospace;pointer-events:none}.world-map-detail-status[data-state="loading"]{border-color:#746229;color:#ffd879}.world-map-detail-status[data-state="error"]{border-color:#693b40;color:#ff959a}.world-map-detail-status[data-state="ready"]{color:#9ad6a6}.world-map-shell:not(.has-map-preview) .world-map-detail-status{display:none}
+.world-map-detail-controls{display:grid;grid-template-columns:1fr 1fr;gap:10px}.world-map-camera-field{display:grid;gap:4px;padding:7px 8px;border:1px solid var(--line);border-radius:6px;background:var(--bg)}.world-map-camera-field>span{color:var(--muted);font-size:.68rem}.world-map-camera-field output{font:650 .72rem/1.35 ui-monospace,SFMono-Regular,Consolas,monospace}
+.world-map-create-hint{position:absolute;z-index:3;left:14px;bottom:76px;padding:5px 9px;border:1px solid var(--line-soft);border-radius:999px;background:rgba(32,31,32,.82);color:var(--muted);font-size:.62rem;pointer-events:none}.world-map-shell:not(.has-map-preview) .world-map-create-hint{display:none}
+.world-map-city-dialog{position:absolute;z-index:4;top:14px;right:338px;width:min(560px,calc(100% - 366px));max-height:calc(100% - 94px);margin:0;overflow:auto;padding:0;border:1px solid var(--line);border-radius:var(--radius);background:rgba(32,31,32,.97);color:var(--text);box-shadow:var(--shadow)}.world-map-city-dialog::backdrop{background:rgba(0,0,0,.58)}.world-map-city-form{display:grid;gap:14px;padding:18px}.world-map-city-form h2,.world-map-city-form h3{margin:0}.world-map-city-form h2{font-size:1rem}.world-map-city-form h3{font-size:.76rem;color:var(--muted)}.world-map-city-grid{display:grid;grid-template-columns:2fr 1fr 1fr;gap:10px}.world-map-city-grid.land-use{grid-template-columns:repeat(5,1fr)}.world-map-city-form .world-map-field input,.world-map-city-form .world-map-field select{min-width:0;width:100%;padding:7px 8px;border:1px solid var(--line);border-radius:6px;background:var(--bg);color:var(--text);font-size:.75rem;outline:none}.world-map-city-dialog-status{min-height:1.2em;margin:0;color:var(--muted);font-size:.72rem}.world-map-city-dialog-status[data-state="loading"]{color:#ffd879}.world-map-city-dialog-status[data-state="error"]{color:#ff959a}.world-map-city-actions{display:flex;justify-content:flex-end;gap:8px}
+@media(max-width:850px){.world-map-detail-status{top:58px;left:10px}.world-map-create-hint{display:none}.world-map-road-legend{display:none}.world-map-city-dialog{top:64px;right:14px;width:calc(100% - 28px);max-height:calc(100% - 142px)}.world-map-detail-controls,.world-map-city-grid,.world-map-city-grid.land-use{grid-template-columns:1fr 1fr}}