customforge 0.1.0-alpha.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/core/config.ts","../src/core/dom.ts","../src/core/design.ts","../src/editor/objectBounds.ts","../src/editor/imageSource.ts","../src/editor/DesignEditor.ts","../src/bridge/TextureBridge.ts","../src/viewer/ProductViewer.ts","../src/customizer/ProductCustomizer.ts","../src/index.ts"],"sourcesContent":["import type { ProductConfiguration } from './types'\r\n\r\n/** 默认接收实时纹理的 Mesh 名称 */\r\nexport const DEFAULT_SURFACE_MESH = 'PrintArea'\r\n\r\n/**\r\n * 完成默认值补全后的内部产品配置\r\n */\r\nexport interface NormalizedProductConfiguration {\r\n  /** 清理空白后的模型地址 */\r\n  modelUrl?: string\r\n\r\n  /** 清理空白后的基础纹理地址 */\r\n  textureUrl?: string\r\n\r\n  /** 接收实时纹理的 Mesh 名称 */\r\n  surfaceMesh: string\r\n\r\n  /** 是否垂直翻转 CanvasTexture */\r\n  textureFlipY: boolean\r\n}\r\n\r\n/**\r\n * 清理产品配置并补全运行所需的默认值\r\n *\r\n * 远程模型默认不翻转纹理，内置演示模型默认翻转纹理\r\n *\r\n * @param product 外部传入的产品配置\r\n * @returns 可以直接交给编辑器和查看器使用的完整配置\r\n */\r\nexport function normalizeProductConfiguration(\r\n  product: ProductConfiguration = {},\r\n): NormalizedProductConfiguration {\r\n  const modelUrl = product.modelUrl?.trim() || undefined\r\n  const textureUrl = product.textureUrl?.trim() || undefined\r\n  const surfaceMesh = product.surfaceMesh?.trim() || DEFAULT_SURFACE_MESH\r\n\r\n  return {\r\n    modelUrl,\r\n    textureUrl,\r\n    surfaceMesh,\r\n    textureFlipY: product.textureFlipY ?? !modelUrl,\r\n  }\r\n}\r\n","import type { ElementTarget } from './types'\r\n\r\n/**\r\n * 将 HTMLElement 或 CSS 选择器解析为挂载容器\r\n *\r\n * @param target DOM 元素或 CSS 选择器\r\n * @param label 错误消息中使用的容器名称\r\n * @returns 解析得到的 DOM 元素\r\n * @throws CSS 选择器无法找到对应元素时抛出错误\r\n */\r\nexport function resolveElement(target: ElementTarget, label: string): HTMLElement {\r\n  if (target instanceof HTMLElement) {\r\n    return target\r\n  }\r\n\r\n  const element = document.querySelector<HTMLElement>(target)\r\n  if (!element) {\r\n    throw new Error(`${label} element was not found: ${target}`)\r\n  }\r\n\r\n  return element\r\n}\r\n","import type {\n  DesignDocument,\n  DesignObject,\n  DesignObjectTransform,\n} from './types'\n\n/** 当前支持的 Design JSON Schema 版本 */\nexport const DESIGN_SCHEMA_VERSION = 1\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction readRecord(value: unknown, path: string): Record<string, unknown> {\n  if (!isRecord(value)) {\n    throw new TypeError(`${path} must be an object`)\n  }\n  return value\n}\n\nfunction readString(\n  value: unknown,\n  path: string,\n  allowEmpty = false,\n): string {\n  if (typeof value !== 'string' || (!allowEmpty && value.trim().length === 0)) {\n    throw new TypeError(`${path} must be ${allowEmpty ? 'a string' : 'a non-empty string'}`)\n  }\n  return value\n}\n\nfunction readFiniteNumber(value: unknown, path: string): number {\n  if (typeof value !== 'number' || !Number.isFinite(value)) {\n    throw new TypeError(`${path} must be a finite number`)\n  }\n  return value\n}\n\nfunction readPositiveNumber(value: unknown, path: string): number {\n  const number = readFiniteNumber(value, path)\n  if (number <= 0) {\n    throw new TypeError(`${path} must be greater than zero`)\n  }\n  return number\n}\n\nfunction readBoolean(value: unknown, path: string): boolean {\n  if (typeof value !== 'boolean') {\n    throw new TypeError(`${path} must be a boolean`)\n  }\n  return value\n}\n\nfunction parseTransform(value: unknown, path: string): DesignObjectTransform {\n  const transform = readRecord(value, path)\n  return {\n    x: readFiniteNumber(transform.x, `${path}.x`),\n    y: readFiniteNumber(transform.y, `${path}.y`),\n    scaleX: readPositiveNumber(transform.scaleX, `${path}.scaleX`),\n    scaleY: readPositiveNumber(transform.scaleY, `${path}.scaleY`),\n    rotation: readFiniteNumber(transform.rotation, `${path}.rotation`),\n    flipX: readBoolean(transform.flipX, `${path}.flipX`),\n    flipY: readBoolean(transform.flipY, `${path}.flipY`),\n  }\n}\n\nfunction parseObject(value: unknown, index: number): DesignObject {\n  const path = `design.objects[${index}]`\n  const object = readRecord(value, path)\n  const id = readString(object.id, `${path}.id`)\n  const transform = parseTransform(object.transform, `${path}.transform`)\n\n  if (object.type === 'text') {\n    return {\n      id,\n      type: 'text',\n      transform,\n      text: readString(object.text, `${path}.text`, true),\n      width: readPositiveNumber(object.width, `${path}.width`),\n      fontFamily: readString(object.fontFamily, `${path}.fontFamily`),\n      fontSize: readPositiveNumber(object.fontSize, `${path}.fontSize`),\n      color: readString(object.color, `${path}.color`),\n    }\n  }\n\n  if (object.type === 'image') {\n    const src = readString(object.src, `${path}.src`)\n    if (src.startsWith('blob:')) {\n      throw new TypeError(`${path}.src must not use a Blob URL`)\n    }\n    return { id, type: 'image', transform, src }\n  }\n\n  throw new TypeError(`${path}.type is not supported`)\n}\n\n/**\n * 校验并净化外部 Design JSON\n *\n * @param value JSON.parse 结果或其他未知输入\n * @returns 只包含当前 Schema 字段的新设计文档\n * @throws 文档版本、字段类型、对象 ID 或图片来源不符合契约时抛出 TypeError\n */\nexport function parseDesignDocument(value: unknown): DesignDocument {\n  const design = readRecord(value, 'design')\n  if (design.version !== DESIGN_SCHEMA_VERSION) {\n    throw new TypeError(`design.version must be ${DESIGN_SCHEMA_VERSION}`)\n  }\n\n  const canvas = readRecord(design.canvas, 'design.canvas')\n  if (!Array.isArray(design.objects)) {\n    throw new TypeError('design.objects must be an array')\n  }\n\n  const objects = design.objects.map(parseObject)\n  const ids = new Set<string>()\n  for (const object of objects) {\n    if (ids.has(object.id)) {\n      throw new TypeError(`design object id is duplicated: ${object.id}`)\n    }\n    ids.add(object.id)\n  }\n\n  return {\n    version: DESIGN_SCHEMA_VERSION,\n    canvas: {\n      width: readPositiveNumber(canvas.width, 'design.canvas.width'),\n      height: readPositiveNumber(canvas.height, 'design.canvas.height'),\n    },\n    objects,\n  }\n}\n","/** 参与画布边界计算的轴对齐包围盒 */\nexport interface ObjectBounds {\n  /** 包围盒左边缘的画布横坐标 */\n  left: number\n\n  /** 包围盒上边缘的画布纵坐标 */\n  top: number\n\n  /** 包围盒宽度 */\n  width: number\n\n  /** 包围盒高度 */\n  height: number\n}\n\n/** 将对象包围盒移回画布所需的偏移量 */\nexport interface ContainmentOffset {\n  /** 应加到对象横坐标的偏移量 */\n  x: number\n\n  /** 应加到对象纵坐标的偏移量 */\n  y: number\n}\n\n/**\n * 计算对象完整进入画布所需的最大等比缩放系数\n *\n * @param bounds 对象当前的轴对齐包围盒\n * @param canvasWidth 画布逻辑宽度\n * @param canvasHeight 画布逻辑高度\n * @returns 不大于 1 的缩放系数，对象已经可容纳时返回 1\n */\nexport function calculateContainmentScale(\n  bounds: ObjectBounds,\n  canvasWidth: number,\n  canvasHeight: number,\n): number {\n  const widthScale = bounds.width > canvasWidth ? canvasWidth / bounds.width : 1\n  const heightScale = bounds.height > canvasHeight ? canvasHeight / bounds.height : 1\n  return Math.min(widthScale, heightScale, 1)\n}\n\n/**\n * 计算可容纳对象移回画布所需的平移距离\n *\n * 调用前应先确保包围盒不大于画布，否则无法同时满足两侧边界\n *\n * @param bounds 对象当前的轴对齐包围盒\n * @param canvasWidth 画布逻辑宽度\n * @param canvasHeight 画布逻辑高度\n * @returns 应叠加到对象位置的画布坐标偏移量\n */\nexport function calculateContainmentOffset(\n  bounds: ObjectBounds,\n  canvasWidth: number,\n  canvasHeight: number,\n): ContainmentOffset {\n  const x =\n    bounds.left < 0\n      ? -bounds.left\n      : Math.min(0, canvasWidth - bounds.left - bounds.width)\n  const y =\n    bounds.top < 0\n      ? -bounds.top\n      : Math.min(0, canvasHeight - bounds.top - bounds.height)\n\n  return { x, y }\n}\n","function readBlobAsDataUrl(blob: Blob): Promise<string> {\n  return new Promise((resolve, reject) => {\n    const reader = new FileReader()\n    reader.addEventListener('load', () => {\n      if (typeof reader.result === 'string') {\n        resolve(reader.result)\n      } else {\n        reject(new Error('Blob image could not be converted to a Data URL'))\n      }\n    })\n    reader.addEventListener('error', () => {\n      reject(reader.error ?? new Error('Blob image could not be read'))\n    })\n    reader.readAsDataURL(blob)\n  })\n}\n\n/**\n * 将短生命周期 Blob URL 转换为可写入 Design JSON 的 Data URL\n *\n * 远程 URL 和已有 Data URL 会保持不变\n *\n * @param src 图片来源\n * @returns 可跨页面会话重新加载的图片来源\n * @throws Blob URL 已失效或浏览器无法读取对应 Blob 时抛出错误\n */\nexport async function resolvePersistentImageSource(src: string): Promise<string> {\n  if (!src.startsWith('blob:')) {\n    return src\n  }\n\n  const response = await fetch(src)\n  if (!response.ok) {\n    throw new Error(`Blob image could not be loaded: ${response.status}`)\n  }\n  return readBlobAsDataUrl(await response.blob())\n}\n","import {\n  Canvas,\n  FabricImage,\n  Textbox,\n  type FabricObject,\n} from 'fabric'\nimport { parseDesignDocument } from '../core/design'\nimport type {\n  AddImageOptions,\n  AddTextOptions,\n  DesignDocument,\n  DesignObject,\n  DesignObjectTransform,\n} from '../core/types'\nimport {\n  calculateContainmentOffset,\n  calculateContainmentScale,\n} from './objectBounds'\nimport { resolvePersistentImageSource } from './imageSource'\n\r\n/** 二维编辑器内部初始化配置 */\r\ninterface DesignEditorOptions {\r\n  /** 画布逻辑宽度，单位为像素 */\r\n  width: number\r\n\r\n  /** 画布逻辑高度，单位为像素 */\r\n  height: number\r\n}\r\n\r\ntype RenderListener = () => void\r\ntype SelectionListener = (hasSelection: boolean) => void\r\n\r\n/**\r\n * 基于 Fabric.js 的二维纹理编辑器\r\n *\r\n * 负责基础纹理、文字、图片、对象选择和 PNG 导出\r\n * 显示尺寸可以响应容器变化，内部逻辑尺寸保持不变\r\n */\r\nexport class DesignEditor {\r\n  /** 当前实例使用的 Fabric Canvas */\r\n  readonly canvas: Canvas\r\n\r\n  private readonly host: HTMLElement\r\n  private readonly width: number\r\n  private readonly height: number\r\n  private readonly renderListeners = new Set<RenderListener>()\n  private readonly selectionListeners = new Set<SelectionListener>()\n  private readonly objectIds = new WeakMap<FabricObject, string>()\n  private readonly usedObjectIds = new Set<string>()\n  private readonly imageSources = new WeakMap<FabricImage, string>()\n  private readonly resizeObserver: ResizeObserver\n  private objectIdSequence = 0\n\r\n  /**\r\n   * @param host 二维编辑器挂载容器\r\n   * @param options 画布逻辑尺寸\r\n   */\r\n  constructor(host: HTMLElement, options: DesignEditorOptions) {\r\n    this.host = host\r\n    this.width = options.width\r\n    this.height = options.height\r\n\r\n    const element = document.createElement('canvas')\r\n    element.setAttribute('aria-label', 'UV texture editor')\r\n    host.replaceChildren(element)\r\n\r\n    this.canvas = new Canvas(element, {\r\n      width: this.width,\r\n      height: this.height,\r\n      backgroundColor: '#f7f7f5',\r\n      preserveObjectStacking: true,\r\n      selectionColor: 'rgba(19, 113, 125, 0.12)',\r\n      selectionBorderColor: '#13717d',\r\n    })\r\n\r\n    this.canvas.wrapperEl.classList.add('customforge-design-canvas')\n    this.host.dataset.renderState = 'pending'\r\n    this.canvas.on('after:render', () => {\r\n      this.markRenderState()\r\n      this.renderListeners.forEach((listener) => listener())\r\n    })\r\n\r\n    const notifySelection = () => {\r\n      const hasSelection = Boolean(this.canvas.getActiveObject())\r\n      this.selectionListeners.forEach((listener) => listener(hasSelection))\r\n    }\r\n\r\n    this.canvas.on('selection:created', notifySelection)\n    this.canvas.on('selection:updated', notifySelection)\n    this.canvas.on('selection:cleared', notifySelection)\n\n    const constrainTarget = ({ target }: { target: FabricObject }) => {\n      this.constrainObjectToCanvas(target)\n    }\n    this.canvas.on('object:moving', constrainTarget)\n    this.canvas.on('object:scaling', constrainTarget)\n    this.canvas.on('object:rotating', constrainTarget)\n    this.canvas.on('object:skewing', constrainTarget)\n    this.canvas.on('object:resizing', constrainTarget)\n    this.canvas.on('object:modified', constrainTarget)\n    this.canvas.on('text:changed', constrainTarget)\n\r\n    this.resizeObserver = new ResizeObserver(() => this.resizeDisplay())\r\n    this.resizeObserver.observe(host)\r\n    this.resizeDisplay()\r\n  }\r\n\r\n  /** 供 Three.js 创建 CanvasTexture 的底层 HTML Canvas */\r\n  get textureCanvas(): HTMLCanvasElement {\r\n    return this.canvas.getElement()\r\n  }\r\n\r\n  /** 当前画布中可编辑对象的数量，不包含背景纹理 */\r\n  get objectCount(): number {\r\n    return this.canvas.getObjects().length\r\n  }\r\n\r\n  /**\r\n   * 订阅 Fabric Canvas 完成渲染事件\r\n   *\r\n   * @param listener 每次画布完成渲染后调用的函数\r\n   * @returns 用于取消本次订阅的函数\r\n   */\r\n  onRender(listener: RenderListener): () => void {\r\n    this.renderListeners.add(listener)\r\n    return () => this.renderListeners.delete(listener)\r\n  }\r\n\r\n  /**\r\n   * 订阅画布选中状态变化\r\n   *\r\n   * @param listener 接收当前是否存在选区的函数\r\n   * @returns 用于取消本次订阅的函数\r\n   */\r\n  onSelectionChange(listener: SelectionListener): () => void {\r\n    this.selectionListeners.add(listener)\r\n    return () => this.selectionListeners.delete(listener)\r\n  }\r\n\r\n  /**\r\n   * 设置铺满画布的基础纹理，不传地址时恢复默认背景色\r\n   *\r\n   * 背景纹理不参与对象选择，但会包含在实时纹理和 PNG 导出中\r\n   *\r\n   * @param url 基础纹理地址\r\n   * @throws 图片加载失败或被 CORS 策略阻止时抛出错误\r\n   */\r\n  async setBackgroundTexture(url?: string): Promise<void> {\r\n    if (!url) {\r\n      this.canvas.backgroundImage = undefined\r\n      this.canvas.backgroundColor = '#f7f7f5'\r\n      this.canvas.requestRenderAll()\r\n      return\r\n    }\r\n\r\n    const image = await FabricImage.fromURL(url, { crossOrigin: 'anonymous' })\r\n    const scaleX = this.width / Math.max(image.width, 1)\r\n    const scaleY = this.height / Math.max(image.height, 1)\r\n\r\n    image.set({\r\n      left: 0,\r\n      top: 0,\r\n      originX: 'left',\r\n      originY: 'top',\r\n      scaleX,\r\n      scaleY,\r\n      selectable: false,\r\n      evented: false,\r\n    })\r\n\r\n    this.canvas.backgroundImage = image\r\n    this.canvas.requestRenderAll()\r\n  }\r\n\r\n  /**\r\n   * 添加并选中一个可编辑文字对象\n   *\n   * 文字位置使用画布像素坐标，原点位于对象左上角\n   * 对象过大时会等比缩小，越界时会自动移回画布\n   *\r\n   * @param options 文字内容、位置和样式\r\n   * @returns 创建的 Fabric Textbox\r\n   */\r\n  addText(options: AddTextOptions = {}): Textbox {\r\n    const text = new Textbox(options.text ?? 'Edit this text', {\r\n      left: options.x ?? this.width * 0.18,\r\n      top: options.y ?? this.height * 0.36,\r\n      width: options.width ?? this.width * 0.42,\r\n      fontFamily: options.fontFamily ?? 'Arial',\r\n      fontSize: options.fontSize ?? Math.round(this.height * 0.12),\r\n      fontWeight: 700,\r\n      fill: options.color ?? '#172126',\r\n      originX: 'left',\r\n      originY: 'top',\r\n      textAlign: 'center',\r\n      editable: true,\r\n      transparentCorners: false,\r\n      cornerColor: '#ffffff',\r\n      cornerStrokeColor: '#13717d',\r\n      borderColor: '#13717d',\r\n      cornerSize: 16,\r\n    })\r\n\r\n    this.addAndSelect(text)\r\n    return text\r\n  }\r\n\r\n  /**\r\n   * 加载、添加并选中一个图片对象\r\n   *\r\n   * 图片位置使用画布像素坐标，原点位于图片中心\n   * 对象过大时会等比缩小，越界时会自动移回画布\n   * 远程图片必须提供正确的 CORS 响应头才能安全导出 PNG\n   *\r\n   * @param options 图片地址、中心位置和显示宽度\r\n   * @returns 创建的 FabricImage\r\n   * @throws 图片加载失败或被 CORS 策略阻止时抛出错误\r\n   */\r\n  async addImage(options: AddImageOptions): Promise<FabricImage> {\n    const source = await resolvePersistentImageSource(options.src)\n    const image = await this.loadImage(source)\n    const targetWidth = options.width ?? this.width * 0.22\n    const scale = targetWidth / Math.max(image.width, 1)\n\r\n    image.set({\r\n      left: options.x ?? this.width * 0.62,\r\n      top: options.y ?? this.height * 0.29,\r\n      originX: 'center',\r\n      originY: 'center',\r\n      scaleX: scale,\r\n      scaleY: scale,\r\n      transparentCorners: false,\r\n      cornerColor: '#ffffff',\r\n      cornerStrokeColor: '#13717d',\r\n      borderColor: '#13717d',\r\n      cornerSize: 16,\r\n    })\n\n    this.imageSources.set(image, source)\n    this.addAndSelect(image)\n    return image\n  }\n\n  /**\n   * 返回与 Fabric.js 无关的当前设计快照\n   *\n   * 文档只包含可编辑对象和逻辑画布尺寸，不包含背景纹理或产品模型配置\n   *\n   * @returns 可以安全传给 JSON.stringify 的 Design JSON 文档\n   * @throws 画布包含不支持的对象或非字符串文字填充时抛出错误\n   */\n  saveDesign(): DesignDocument {\n    return {\n      version: 1,\n      canvas: { width: this.width, height: this.height },\n      objects: this.canvas.getObjects().map((object) => this.serializeObject(object)),\n    }\n  }\n\n  /**\n   * 校验并恢复 Design JSON，图片全部加载成功后才替换当前对象\n   *\n   * 背景纹理和当前产品保持不变，恢复后不选中任何对象\n   *\n   * @param value JSON.parse 结果或符合 DesignDocument 的对象\n   * @throws Schema 无效、画布尺寸不匹配或图片无法加载时抛出错误\n   */\n  async loadDesign(value: unknown): Promise<void> {\n    const design = parseDesignDocument(value)\n    if (design.canvas.width !== this.width || design.canvas.height !== this.height) {\n      throw new RangeError(\n        `Design canvas ${design.canvas.width}x${design.canvas.height} does not match editor canvas ${this.width}x${this.height}`,\n      )\n    }\n\n    const entries: Array<{\n      id: string\n      object: FabricObject\n      source?: string\n    }> = []\n\n    try {\n      for (const object of design.objects) {\n        entries.push({\n          id: object.id,\n          object: await this.createObjectFromDesign(object),\n          source: object.type === 'image' ? object.src : undefined,\n        })\n      }\n    } catch (error) {\n      entries.forEach(({ object }) => object.dispose())\n      throw error\n    }\n\n    const previousObjects = this.canvas.getObjects()\n    this.canvas.discardActiveObject()\n    this.canvas.remove(...previousObjects)\n    previousObjects.forEach((object) => object.dispose())\n    this.usedObjectIds.clear()\n\n    for (const entry of entries) {\n      this.registerObject(entry.object, entry.id)\n      if (entry.object instanceof FabricImage && entry.source) {\n        this.imageSources.set(entry.object, entry.source)\n      }\n      this.canvas.add(entry.object)\n      this.constrainObjectToCanvas(entry.object)\n    }\n\n    this.canvas.requestRenderAll()\n    this.selectionListeners.forEach((listener) => listener(false))\n  }\n\r\n  /**\r\n   * 删除当前对象或多选选区\r\n   *\r\n   * @returns 是否删除了至少一个对象\r\n   */\r\n  deleteSelected(): boolean {\r\n    const selection = this.canvas.getActiveObjects()\r\n    if (selection.length === 0) {\r\n      return false\r\n    }\r\n\r\n    this.canvas.remove(...selection)\r\n    this.canvas.discardActiveObject()\r\n    this.canvas.requestRenderAll()\r\n    this.selectionListeners.forEach((listener) => listener(false))\r\n    return true\r\n  }\r\n\r\n  /**\r\n   * 将当前画布内容导出为 PNG 并触发浏览器下载\r\n   *\r\n   * @param filename 下载文件名\r\n   * @throws 画布被无 CORS 授权的远程图片污染时抛出安全错误\r\n   */\r\n  exportTexture(filename = 'custom-texture.png'): void {\r\n    this.canvas.discardActiveObject()\r\n    this.canvas.renderAll()\r\n\r\n    const anchor = document.createElement('a')\r\n    anchor.download = filename\r\n    anchor.href = this.canvas.toDataURL({\r\n      format: 'png',\r\n      multiplier: 1,\r\n    })\r\n    anchor.click()\r\n  }\r\n\r\n  /** 释放 ResizeObserver、事件监听和 Fabric Canvas */\r\n  destroy(): void {\r\n    this.resizeObserver.disconnect()\r\n    this.renderListeners.clear()\r\n    this.selectionListeners.clear()\r\n    this.canvas.dispose()\r\n    this.host.replaceChildren()\r\n  }\r\n\r\n  private addAndSelect(object: FabricObject): void {\n    this.registerObject(object)\n    this.canvas.add(object)\n    this.constrainObjectToCanvas(object)\n    this.canvas.setActiveObject(object)\n    this.canvas.requestRenderAll()\n    this.selectionListeners.forEach((listener) => listener(true))\n  }\n\n  private registerObject(object: FabricObject, id = this.createObjectId()): void {\n    if (this.usedObjectIds.has(id)) {\n      throw new Error(`Design object id is already in use: ${id}`)\n    }\n    this.usedObjectIds.add(id)\n    this.objectIds.set(object, id)\n  }\n\n  private createObjectId(): string {\n    let id: string\n    do {\n      this.objectIdSequence += 1\n      id = `object-${this.objectIdSequence}`\n    } while (this.usedObjectIds.has(id))\n    return id\n  }\n\n  private serializeObject(object: FabricObject): DesignObject {\n    const id = this.objectIds.get(object)\n    if (!id) {\n      throw new Error('Design object is missing its stable id')\n    }\n\n    const transform = this.serializeTransform(object)\n    if (object instanceof Textbox) {\n      if (typeof object.fill !== 'string') {\n        throw new Error(`Text object ${id} uses an unsupported non-string fill`)\n      }\n      return {\n        id,\n        type: 'text',\n        transform,\n        text: object.text,\n        width: object.width,\n        fontFamily: object.fontFamily,\n        fontSize: object.fontSize,\n        color: object.fill,\n      }\n    }\n\n    if (object instanceof FabricImage) {\n      const src = this.imageSources.get(object) ?? object.getSrc()\n      if (!src || src.startsWith('blob:')) {\n        throw new Error(`Image object ${id} does not have a persistent source`)\n      }\n      return { id, type: 'image', transform, src }\n    }\n\n    throw new Error(`Design object ${id} has an unsupported type`)\n  }\n\n  private serializeTransform(object: FabricObject): DesignObjectTransform {\n    const center = object.getCenterPoint()\n    return {\n      x: center.x,\n      y: center.y,\n      scaleX: Math.abs(object.scaleX),\n      scaleY: Math.abs(object.scaleY),\n      rotation: object.angle,\n      flipX: object.scaleX < 0 ? !object.flipX : object.flipX,\n      flipY: object.scaleY < 0 ? !object.flipY : object.flipY,\n    }\n  }\n\n  private async createObjectFromDesign(design: DesignObject): Promise<FabricObject> {\n    const common = {\n      left: design.transform.x,\n      top: design.transform.y,\n      originX: 'center' as const,\n      originY: 'center' as const,\n      scaleX: design.transform.scaleX,\n      scaleY: design.transform.scaleY,\n      angle: design.transform.rotation,\n      flipX: design.transform.flipX,\n      flipY: design.transform.flipY,\n      transparentCorners: false,\n      cornerColor: '#ffffff',\n      cornerStrokeColor: '#13717d',\n      borderColor: '#13717d',\n      cornerSize: 16,\n    }\n\n    if (design.type === 'text') {\n      return new Textbox(design.text, {\n        ...common,\n        width: design.width,\n        fontFamily: design.fontFamily,\n        fontSize: design.fontSize,\n        fontWeight: 700,\n        fill: design.color,\n        textAlign: 'center',\n        editable: true,\n      })\n    }\n\n    const image = await this.loadImage(design.src)\n    image.set(common)\n    return image\n  }\n\n  private loadImage(source: string): Promise<FabricImage> {\n    return FabricImage.fromURL(\n      source,\n      source.startsWith('data:') ? undefined : { crossOrigin: 'anonymous' },\n    )\n  }\n\n  private constrainObjectToCanvas(object: FabricObject): void {\n    object.setCoords()\n    let bounds = object.getBoundingRect()\n    const scale = calculateContainmentScale(bounds, this.width, this.height)\n\n    if (scale < 1) {\n      object.set({\n        scaleX: object.scaleX * scale,\n        scaleY: object.scaleY * scale,\n      })\n      object.setCoords()\n      bounds = object.getBoundingRect()\n    }\n\n    const offset = calculateContainmentOffset(bounds, this.width, this.height)\n    if (offset.x !== 0 || offset.y !== 0) {\n      object.set({\n        left: object.left + offset.x,\n        top: object.top + offset.y,\n      })\n      object.setCoords()\n    }\n  }\n\r\n  private resizeDisplay(): void {\r\n    const availableWidth = Math.max(this.host.clientWidth - 32, 1)\r\n    const availableHeight = Math.max(this.host.clientHeight - 32, 1)\r\n    const scale = Math.min(\r\n      availableWidth / this.width,\r\n      availableHeight / this.height,\r\n      1,\r\n    )\r\n\r\n    this.canvas.setDimensions(\r\n      {\r\n        width: `${Math.floor(this.width * scale)}px`,\r\n        height: `${Math.floor(this.height * scale)}px`,\r\n      },\r\n      { cssOnly: true },\r\n    )\r\n  }\r\n\r\n  private markRenderState(): void {\r\n    if (this.host.dataset.renderState === 'nonblank') {\r\n      return\r\n    }\r\n\r\n    const context = this.canvas.getContext()\r\n    let minimum = 255\r\n    let maximum = 0\r\n    let opaqueSamples = 0\r\n\r\n    for (let row = 1; row < 8; row += 1) {\r\n      for (let column = 1; column < 16; column += 1) {\r\n        const x = Math.floor((column / 16) * this.width)\r\n        const y = Math.floor((row / 8) * this.height)\r\n        const pixel = context.getImageData(x, y, 1, 1).data\r\n        const luminance = (pixel[0] + pixel[1] + pixel[2]) / 3\r\n        minimum = Math.min(minimum, luminance)\r\n        maximum = Math.max(maximum, luminance)\r\n        if (pixel[3] > 0) {\r\n          opaqueSamples += 1\r\n        }\r\n      }\r\n    }\r\n\r\n    if (opaqueSamples > 0 && maximum - minimum > 8) {\r\n      this.host.dataset.renderState = 'nonblank'\r\n    }\r\n  }\r\n}\r\n","import { CanvasTexture, SRGBColorSpace } from 'three'\r\nimport type { DesignEditor } from '../editor/DesignEditor'\r\nimport type { ProductViewer } from '../viewer/ProductViewer'\r\n\r\n/**\r\n * 将二维编辑画布转换为 Three.js 实时纹理\r\n *\r\n * 多次画布渲染会合并到下一个动画帧，避免重复标记纹理更新\r\n */\r\nexport class TextureBridge {\r\n  /** 绑定到三维产品材质的实时 CanvasTexture */\r\n  readonly texture: CanvasTexture\r\n\r\n  private readonly stopListening: () => void\r\n  private updateFrame = 0\r\n\r\n  /**\r\n   * @param editor 提供底层 HTML Canvas 和渲染事件的二维编辑器\r\n   * @param viewer 接收实时纹理的三维查看器\r\n   * @param flipY 是否垂直翻转纹理\r\n   */\r\n  constructor(editor: DesignEditor, viewer: ProductViewer, flipY: boolean) {\r\n    this.texture = new CanvasTexture(editor.textureCanvas)\r\n    this.texture.colorSpace = SRGBColorSpace\r\n    this.texture.flipY = flipY\r\n    this.texture.anisotropy = 4\r\n    viewer.setTexture(this.texture)\r\n\r\n    this.stopListening = editor.onRender(() => this.scheduleUpdate())\r\n    this.scheduleUpdate()\r\n  }\r\n\r\n  /**\r\n   * 更新纹理垂直翻转状态并立即标记刷新\r\n   *\r\n   * @param flipY 是否垂直翻转纹理\r\n   */\r\n  setFlipY(flipY: boolean): void {\r\n    this.texture.flipY = flipY\r\n    this.texture.needsUpdate = true\r\n  }\r\n\r\n  /** 取消编辑器订阅、动画帧并释放 CanvasTexture */\r\n  destroy(): void {\r\n    this.stopListening()\r\n    cancelAnimationFrame(this.updateFrame)\r\n    this.texture.dispose()\r\n  }\r\n\r\n  /** 将同一帧内的多次画布渲染合并为一次纹理更新 */\r\n  private scheduleUpdate(): void {\r\n    if (this.updateFrame) {\r\n      return\r\n    }\r\n\r\n    this.updateFrame = requestAnimationFrame(() => {\r\n      this.updateFrame = 0\r\n      this.texture.needsUpdate = true\r\n    })\r\n  }\r\n}\r\n","import {\r\n  ACESFilmicToneMapping,\r\n  Box3,\r\n  CircleGeometry,\r\n  Color,\r\n  CylinderGeometry,\r\n  DirectionalLight,\r\n  Group,\r\n  HemisphereLight,\r\n  MathUtils,\r\n  Mesh,\r\n  MeshStandardMaterial,\r\n  Object3D,\r\n  PerspectiveCamera,\r\n  PlaneGeometry,\r\n  Scene,\r\n  SRGBColorSpace,\r\n  TorusGeometry,\r\n  Vector3,\r\n  WebGLRenderer,\r\n  type CanvasTexture,\r\n  type Material,\r\n} from 'three'\r\nimport { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js'\r\nimport { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js'\r\nimport type { NormalizedProductConfiguration } from '../core/config'\r\n\r\n/**\r\n * 基于 Three.js 的三维产品查看器\r\n *\r\n * 负责模型加载、目标 Mesh 查找、实时纹理绑定、相机控制和资源释放\r\n * 当前只将纹理应用到目标 Mesh 的第一个材质槽\r\n */\r\nexport class ProductViewer {\r\n  private readonly host: HTMLElement\r\n  private readonly scene = new Scene()\r\n  private readonly camera = new PerspectiveCamera(35, 1, 0.05, 100)\r\n  private readonly renderer: WebGLRenderer\r\n  private readonly controls: OrbitControls\r\n  private readonly loader = new GLTFLoader()\r\n  private readonly resizeObserver: ResizeObserver\r\n  private productRoot?: Object3D\r\n  private surface?: Mesh\r\n  private texture?: CanvasTexture\r\n  private animationFrame = 0\r\n\r\n  /**\r\n   * @param host 三维查看器挂载容器\r\n   */\r\n  constructor(host: HTMLElement) {\r\n    this.host = host\r\n    host.replaceChildren()\r\n\r\n    this.renderer = new WebGLRenderer({ antialias: true, alpha: true })\r\n    this.renderer.setPixelRatio(Math.min(window.devicePixelRatio, 2))\r\n    this.renderer.outputColorSpace = SRGBColorSpace\r\n    this.renderer.toneMapping = ACESFilmicToneMapping\r\n    this.renderer.toneMappingExposure = 1.05\r\n    this.renderer.shadowMap.enabled = true\n    this.renderer.domElement.setAttribute('aria-label', 'Interactive 3D product preview')\n    this.renderer.domElement.classList.add('customforge-viewer-canvas')\n    host.append(this.renderer.domElement)\n    host.dataset.renderState = 'pending'\r\n\r\n    this.scene.background = new Color('#eef0ef')\r\n    this.camera.position.set(4.6, 2.8, 5.8)\r\n\r\n    this.controls = new OrbitControls(this.camera, this.renderer.domElement)\r\n    this.controls.enableDamping = true\r\n    this.controls.minDistance = 3.2\r\n    this.controls.maxDistance = 11\r\n    this.controls.target.set(0, 0, 0)\r\n\r\n    this.addEnvironment()\r\n    this.resizeObserver = new ResizeObserver(() => this.resize())\r\n    this.resizeObserver.observe(host)\r\n    this.resize()\r\n    this.render()\r\n  }\r\n\r\n  /**\r\n   * 加载远程模型或创建内置演示模型\r\n   *\r\n   * @param product 已完成默认值补全的产品配置\r\n   * @throws 模型加载失败或找不到目标 Mesh 时抛出错误\r\n   */\r\n  async loadProduct(product: NormalizedProductConfiguration): Promise<void> {\r\n    this.removeProduct()\r\n\r\n    if (product.modelUrl) {\r\n      const gltf = await this.loader.loadAsync(product.modelUrl)\r\n      this.productRoot = gltf.scene\r\n      this.surface = this.findSurface(gltf.scene, product.surfaceMesh)\r\n    } else {\r\n      const demo = this.createDemoProduct()\r\n      this.productRoot = demo.root\r\n      this.surface = demo.surface\r\n    }\r\n\r\n    this.scene.add(this.productRoot)\r\n    if (this.texture) {\r\n      this.attachTexture(this.texture)\r\n    }\r\n    this.fitCamera(this.productRoot)\r\n  }\r\n\r\n  /**\r\n   * 保存并绑定二维编辑器生成的实时纹理\r\n   *\r\n   * 如果模型尚未加载，纹理会在模型加载完成后自动绑定\r\n   *\r\n   * @param texture 由二维画布创建的 CanvasTexture\r\n   */\r\n  setTexture(texture: CanvasTexture): void {\r\n    this.texture = texture\r\n    if (this.surface) {\r\n      this.attachTexture(texture)\r\n    }\r\n  }\r\n\r\n  /** 根据当前模型包围盒恢复默认相机位置 */\r\n  resetView(): void {\r\n    if (this.productRoot) {\r\n      this.fitCamera(this.productRoot)\r\n    }\r\n  }\r\n\r\n  /** 释放动画帧、相机控制、模型材质和 WebGLRenderer */\r\n  destroy(): void {\r\n    cancelAnimationFrame(this.animationFrame)\r\n    this.resizeObserver.disconnect()\r\n    this.controls.dispose()\r\n    this.removeProduct()\r\n    this.renderer.dispose()\r\n    this.renderer.domElement.remove()\r\n  }\r\n\r\n  private addEnvironment(): void {\r\n    const sky = new HemisphereLight('#ffffff', '#7c8581', 2.2)\r\n    this.scene.add(sky)\r\n\r\n    const key = new DirectionalLight('#ffffff', 3.8)\r\n    key.position.set(4, 6, 5)\r\n    key.castShadow = true\r\n    this.scene.add(key)\r\n\r\n    const fill = new DirectionalLight('#b7dce0', 1.2)\r\n    fill.position.set(-5, 2, 3)\r\n    this.scene.add(fill)\r\n\r\n    const floor = new Mesh(\r\n      new PlaneGeometry(30, 30),\r\n      new MeshStandardMaterial({ color: '#dfe3e1', roughness: 0.95 }),\r\n    )\r\n    floor.rotation.x = -Math.PI / 2\r\n    floor.position.y = -1.34\r\n    floor.receiveShadow = true\r\n    this.scene.add(floor)\r\n  }\r\n\r\n  private createDemoProduct(): { root: Group; surface: Mesh } {\r\n    const root = new Group()\r\n    root.rotation.y = MathUtils.degToRad(-14)\r\n\r\n    const bodyMaterial = new MeshStandardMaterial({\r\n      color: '#ffffff',\r\n      roughness: 0.42,\r\n      metalness: 0,\r\n    })\r\n    const surface = new Mesh(\r\n      new CylinderGeometry(1.28, 1.16, 2.35, 96, 1, true),\r\n      bodyMaterial,\r\n    )\r\n    surface.name = 'PrintArea'\r\n    surface.castShadow = true\r\n    surface.receiveShadow = true\r\n    root.add(surface)\r\n\r\n    const ceramic = new MeshStandardMaterial({\r\n      color: '#f4f4f1',\r\n      roughness: 0.35,\r\n    })\r\n    const rim = new Mesh(new TorusGeometry(1.28, 0.08, 20, 96), ceramic)\r\n    rim.rotation.x = Math.PI / 2\r\n    rim.position.y = 1.18\r\n    rim.castShadow = true\r\n    root.add(rim)\r\n\r\n    const inside = new Mesh(\r\n      new CircleGeometry(1.2, 96),\r\n      new MeshStandardMaterial({ color: '#29312f', roughness: 0.7 }),\r\n    )\r\n    inside.rotation.x = -Math.PI / 2\r\n    inside.position.y = 1.16\r\n    root.add(inside)\r\n\r\n    const bottom = new Mesh(new CircleGeometry(1.15, 96), ceramic)\r\n    bottom.rotation.x = Math.PI / 2\r\n    bottom.position.y = -1.17\r\n    root.add(bottom)\r\n\r\n    return { root, surface }\n  }\r\n\r\n  /**\r\n   * 按名称查找接收实时纹理的 Mesh\r\n   *\r\n   * @throws 找不到对象或同名对象不是 Mesh 时抛出错误\r\n   */\r\n  private findSurface(root: Object3D, meshName: string): Mesh {\r\n    const object = root.getObjectByName(meshName)\r\n    if (!(object instanceof Mesh)) {\r\n      throw new Error(`Customizable mesh was not found: ${meshName}`)\r\n    }\r\n    return object\r\n  }\r\n\r\n  /**\r\n   * 将纹理应用到目标 Mesh 的第一个材质槽\r\n   *\r\n   * 非 MeshStandardMaterial 会被替换为基础标准材质\r\n   */\r\n  private attachTexture(texture: CanvasTexture): void {\r\n    if (!this.surface) {\r\n      return\r\n    }\r\n\r\n    const materials = Array.isArray(this.surface.material)\r\n      ? this.surface.material\r\n      : [this.surface.material]\r\n    const material = materials[0]\r\n\r\n    if (!(material instanceof MeshStandardMaterial)) {\r\n      const replacement = new MeshStandardMaterial({\r\n        color: '#ffffff',\r\n        roughness: 0.45,\r\n        map: texture,\r\n      })\r\n      this.surface.material = replacement\r\n      return\r\n    }\r\n\r\n    material.map = texture\r\n    material.color.set('#ffffff')\r\n    material.needsUpdate = true\r\n  }\r\n\r\n  private fitCamera(root: Object3D): void {\r\n    const bounds = new Box3().setFromObject(root)\r\n    const size = bounds.getSize(new Vector3())\r\n    const center = bounds.getCenter(new Vector3())\r\n    const radius = Math.max(size.x, size.y, size.z) * 0.5\r\n    const distance = Math.max(radius / Math.tan(MathUtils.degToRad(this.camera.fov / 2)), 3)\r\n\r\n    this.controls.target.copy(center)\r\n    this.camera.position.copy(center).add(new Vector3(distance * 0.55, distance * 0.42, distance))\r\n    this.camera.near = Math.max(distance / 100, 0.01)\r\n    this.camera.far = distance * 100\r\n    this.camera.updateProjectionMatrix()\r\n    this.controls.update()\r\n  }\r\n\r\n  private removeProduct(): void {\r\n    if (!this.productRoot) {\r\n      return\r\n    }\r\n\r\n    this.scene.remove(this.productRoot)\r\n    this.productRoot.traverse((object) => {\r\n      if (!(object instanceof Mesh)) {\r\n        return\r\n      }\r\n      object.geometry.dispose()\r\n      const materials: Material[] = Array.isArray(object.material)\r\n        ? object.material\r\n        : [object.material]\r\n      materials.forEach((material) => material.dispose())\r\n    })\r\n    this.productRoot = undefined\r\n    this.surface = undefined\r\n  }\r\n\r\n  private resize(): void {\r\n    const width = Math.max(this.host.clientWidth, 1)\r\n    const height = Math.max(this.host.clientHeight, 1)\r\n    this.renderer.setSize(width, height, false)\r\n    this.camera.aspect = width / height\r\n    this.camera.updateProjectionMatrix()\r\n  }\r\n\r\n  private render = (): void => {\r\n    this.animationFrame = requestAnimationFrame(this.render)\r\n    this.controls.update()\r\n    this.renderer.render(this.scene, this.camera)\r\n    this.markRenderState()\r\n  }\r\n\r\n  private markRenderState(): void {\r\n    if (this.host.dataset.renderState === 'nonblank') {\r\n      return\r\n    }\r\n\r\n    const context = this.renderer.getContext()\r\n    const width = context.drawingBufferWidth\r\n    const height = context.drawingBufferHeight\r\n    if (width < 2 || height < 2) {\r\n      return\r\n    }\r\n\r\n    const pixel = new Uint8Array(4)\r\n    let minimum = 255\r\n    let maximum = 0\r\n\r\n    for (const xRatio of [0.25, 0.5, 0.75]) {\r\n      for (const yRatio of [0.25, 0.5, 0.75]) {\r\n        context.readPixels(\r\n          Math.floor(width * xRatio),\r\n          Math.floor(height * yRatio),\r\n          1,\r\n          1,\r\n          context.RGBA,\r\n          context.UNSIGNED_BYTE,\r\n          pixel,\r\n        )\r\n        const luminance = (pixel[0] + pixel[1] + pixel[2]) / 3\r\n        minimum = Math.min(minimum, luminance)\r\n        maximum = Math.max(maximum, luminance)\r\n      }\r\n    }\r\n\r\n    if (maximum - minimum > 8) {\r\n      this.host.dataset.renderState = 'nonblank'\r\n    }\r\n  }\r\n}\r\n","import { normalizeProductConfiguration } from '../core/config'\r\nimport { resolveElement } from '../core/dom'\r\nimport type {\r\n  AddImageOptions,\n  AddTextOptions,\n  CustomizerEventMap,\n  CustomizerEventName,\n  CustomizerOptions,\n  DesignDocument,\n  ProductConfiguration,\n} from '../core/types'\nimport { DesignEditor } from '../editor/DesignEditor'\r\nimport { TextureBridge } from '../bridge/TextureBridge'\r\nimport { ProductViewer } from '../viewer/ProductViewer'\r\n\r\ntype EventListener<K extends CustomizerEventName> = (\r\n  detail: CustomizerEventMap[K],\r\n) => void\r\n\r\n/**\n * 统一管理二维编辑器、三维查看器和实时纹理同步\n *\n * 仅支持具有 DOM、Canvas、WebGL 和 ResizeObserver 的浏览器环境\n * 每个实例独立持有 DOM 事件、Fabric 状态和 WebGL 资源\n * 不再使用实例时必须调用 `destroy()`\n */\nexport class ProductCustomizer {\n  private readonly events = new EventTarget()\n  private readonly textureBridge: TextureBridge\n  private readonly editor: DesignEditor\n  private readonly viewer: ProductViewer\n  private product: ReturnType<typeof normalizeProductConfiguration>\n  private readonly stopSelectionListener: () => void\n  private readonly stopRenderListener: () => void\n  private destroyed = false\n\r\n  private constructor(options: CustomizerOptions) {\n    const editorHost = resolveElement(options.editor, 'Editor')\n    const viewerHost = resolveElement(options.viewer, 'Viewer')\n\n    if (editorHost === viewerHost) {\n      throw new Error('Editor and viewer must use different elements')\n    }\n\n    this.product = normalizeProductConfiguration(options.product)\n    this.editor = new DesignEditor(editorHost, {\r\n      width: options.editorWidth ?? 1024,\r\n      height: options.editorHeight ?? 512,\r\n    })\r\n    this.viewer = new ProductViewer(viewerHost)\r\n    this.textureBridge = new TextureBridge(\r\n      this.editor,\r\n      this.viewer,\r\n      this.product.textureFlipY,\r\n    )\r\n\r\n    this.stopSelectionListener = this.editor.onSelectionChange((hasSelection) => {\r\n      this.emit('selectionchange', { hasSelection })\r\n    })\r\n    this.stopRenderListener = this.editor.onRender(() => {\r\n      this.emit('change', { objectCount: this.editor.objectCount })\r\n    })\r\n  }\r\n\r\n  /**\n   * 创建实例并完成初始产品加载\n   *\n   * @param options 产品定制器初始化配置\n   * @returns 初始化完成的产品定制器实例\n   * @throws DOM 容器无效或初始化失败时释放已创建资源并继续抛出原始错误\n   */\r\n  static async create(options: CustomizerOptions): Promise<ProductCustomizer> {\r\n    const customizer = new ProductCustomizer(options)\r\n    try {\r\n      await customizer.initialize()\r\n      return customizer\r\n    } catch (error) {\r\n      customizer.destroy()\r\n      throw error\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 订阅产品定制器事件\r\n   *\r\n   * @param event 事件名称\r\n   * @param listener 接收对应事件载荷的监听函数\r\n   * @returns 用于取消本次订阅的函数\r\n   */\r\n  on<K extends CustomizerEventName>(\r\n    event: K,\r\n    listener: EventListener<K>,\r\n  ): () => void {\r\n    const wrapped = (browserEvent: Event) => {\r\n      listener((browserEvent as CustomEvent<CustomizerEventMap[K]>).detail)\r\n    }\r\n    this.events.addEventListener(event, wrapped)\r\n    return () => this.events.removeEventListener(event, wrapped)\r\n  }\r\n\r\n  /**\n   * 在二维画布中添加并选中一个文字对象\n   *\n   * 创建后和用户变换期间，对象会自动缩放或平移以保持完整可见\n   *\n   * @param options 文字内容、位置和样式配置\n   */\r\n  addText(options?: AddTextOptions): void {\r\n    this.editor.addText(options)\r\n  }\r\n\r\n  /**\n   * 加载图片并将其添加到二维画布\n   *\n   * 创建后和用户变换期间，对象会自动缩放或平移以保持完整可见\n   *\n   * @param options 图片地址、位置和显示宽度\n   * @throws 图片无法访问、加载失败或被 CORS 策略阻止时抛出错误\r\n   */\r\n  async addImage(options: AddImageOptions): Promise<void> {\r\n    try {\r\n      await this.editor.addImage(options)\r\n    } catch (error) {\r\n      this.reportError(error)\r\n      throw error\r\n    }\r\n  }\r\n\r\n  /**\r\n   * 删除二维编辑器中的当前对象或选区\r\n   *\r\n   * @returns 是否删除了至少一个对象\r\n   */\r\n  deleteSelected(): boolean {\n    return this.editor.deleteSelected()\n  }\n\n  /**\n   * 创建当前二维设计的版本化 JSON 快照\n   *\n   * 快照不包含产品模型、目标 Mesh 或基础纹理配置\n   * Blob URL 图片会在添加时转换为 Data URL，因此返回值可以跨页面会话保存\n   *\n   * @returns 可以安全传给 JSON.stringify 的 DesignDocument\n   * @throws 设计中存在不支持的对象或文字填充时抛出错误\n   */\n  saveDesign(): DesignDocument {\n    return this.editor.saveDesign()\n  }\n\n  /**\n   * 校验并恢复版本化 Design JSON\n   *\n   * 图片全部加载成功后才替换当前二维对象，产品和基础纹理保持不变\n   * 输入画布尺寸必须与当前编辑器的逻辑尺寸完全一致\n   *\n   * @param value JSON.parse 结果或符合 DesignDocument 的对象\n   * @throws Schema 无效、画布尺寸不匹配或图片加载失败时抛出错误\n   */\n  async loadDesign(value: unknown): Promise<void> {\n    this.emit('status', { message: 'Loading design' })\n    try {\n      await this.editor.loadDesign(value)\n      this.emit('status', { message: 'Design loaded' })\n    } catch (error) {\n      this.reportError(error)\n      throw error\n    }\n  }\n\n  /**\n   * 将当前二维设计合成为 PNG 并触发浏览器下载\n   *\r\n   * @param filename 下载文件名，默认为 `custom-texture.png`\r\n   * @throws 远程图片污染 Canvas 时可能抛出安全错误\r\n   */\r\n  exportTexture(filename?: string): void {\r\n    this.editor.exportTexture(filename)\r\n  }\r\n\r\n  /** 恢复三维产品的默认相机位置 */\r\n  resetView(): void {\r\n    this.viewer.resetView()\r\n  }\r\n\r\n  /**\r\n   * 更换模型、基础纹理和接收纹理的目标 Mesh\r\n   *\r\n   * @param product 新的产品配置\r\n   * @throws 模型或纹理加载失败、目标 Mesh 不存在时抛出错误\r\n   */\r\n  async loadProduct(product: ProductConfiguration): Promise<void> {\r\n    const nextProduct = normalizeProductConfiguration(product)\r\n    this.emit('status', { message: 'Loading product' })\r\n\r\n    try {\r\n      await this.viewer.loadProduct(nextProduct)\r\n      await this.editor.setBackgroundTexture(nextProduct.textureUrl)\r\n      this.textureBridge.setFlipY(nextProduct.textureFlipY)\r\n      this.product = nextProduct\r\n      this.emit('ready', { product: this.product })\r\n      this.emit('status', { message: nextProduct.modelUrl ? 'Remote product ready' : 'Demo product ready' })\r\n    } catch (error) {\r\n      this.reportError(error)\r\n      throw error\r\n    }\r\n  }\r\n\r\n  /**\n   * 释放事件监听、Fabric Canvas、纹理和 WebGL 资源\n   *\n   * 重复调用不会再次释放资源，首次调用后不得继续使用其他实例方法\n   */\n  destroy(): void {\n    if (this.destroyed) {\n      return\n    }\n\n    this.destroyed = true\n    this.stopSelectionListener?.()\n    this.stopRenderListener?.()\n    this.textureBridge.destroy()\r\n    this.editor.destroy()\r\n    this.viewer.destroy()\r\n  }\r\n\r\n  private async initialize(): Promise<void> {\r\n    await this.viewer.loadProduct(this.product)\r\n    await this.editor.setBackgroundTexture(this.product.textureUrl)\r\n    this.textureBridge.setFlipY(this.product.textureFlipY)\r\n    this.emit('ready', { product: this.product })\r\n  }\r\n\r\n  private emit<K extends CustomizerEventName>(\r\n    event: K,\r\n    detail: CustomizerEventMap[K],\r\n  ): void {\r\n    this.events.dispatchEvent(new CustomEvent(event, { detail }))\r\n  }\r\n\r\n  private reportError(error: unknown): void {\r\n    const normalized = error instanceof Error ? error : new Error(String(error))\r\n    this.emit('error', { error: normalized })\r\n    this.emit('status', { message: normalized.message })\r\n  }\r\n}\r\n","import './style.css'\nimport { ProductCustomizer } from './customizer/ProductCustomizer'\nimport type { CustomizerOptions } from './core/types'\n\r\n/**\n * 创建产品定制器实例并完成模型、编辑器和纹理同步初始化\n *\n * 仅支持浏览器环境，应在 DOM 挂载容器可用后调用\n * 编辑器和查看器必须使用两个不同的容器\n * 不再使用返回的实例时必须调用 `destroy()` 释放资源\n *\n * @param options 编辑器容器、查看器容器和产品资源配置\n * @returns 初始化完成的产品定制器实例\n * @throws DOM 容器不存在、两个容器相同、模型加载失败或目标 Mesh 不存在时抛出错误\n *\r\n * @example\r\n * ```ts\r\n * const customizer = await createCustomizer({\r\n *   editor: '#editor',\r\n *   viewer: '#viewer',\r\n *   product: {\r\n *     modelUrl: 'https://example.com/product.glb',\r\n *     surfaceMesh: 'PrintArea',\r\n *   },\r\n * })\r\n * ```\r\n */\r\nexport async function createCustomizer(\r\n  options: CustomizerOptions,\r\n): Promise<ProductCustomizer> {\r\n  return ProductCustomizer.create(options)\r\n}\r\n\r\nexport { ProductCustomizer }\r\nexport type {\r\n  AddImageOptions,\r\n  AddTextOptions,\n  CustomizerEventMap,\n  CustomizerOptions,\n  DesignCanvas,\n  DesignDocument,\n  DesignObject,\n  DesignObjectTransform,\n  ImageDesignObject,\n  ProductConfiguration,\n  TextDesignObject,\n} from './core/types'\n"],"mappings":"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"}

package/dist/style.css

@@ -0,0 +1,12 @@
+.customforge-design-canvas {
+  max-width: 100%;
+  max-height: 100%;
+  overflow: hidden;
+}
+
+.customforge-viewer-canvas {
+  display: block;
+  width: 100%;
+  height: 100%;
+}
+/*$vite$:1*/

package/dist/viewer/ProductViewer.d.ts

@@ -0,0 +1,64 @@
+import { type CanvasTexture } from 'three';
+import type { NormalizedProductConfiguration } from '../core/config';
+/**
+ * 基于 Three.js 的三维产品查看器
+ *
+ * 负责模型加载、目标 Mesh 查找、实时纹理绑定、相机控制和资源释放
+ * 当前只将纹理应用到目标 Mesh 的第一个材质槽
+ */
+export declare class ProductViewer {
+    private readonly host;
+    private readonly scene;
+    private readonly camera;
+    private readonly renderer;
+    private readonly controls;
+    private readonly loader;
+    private readonly resizeObserver;
+    private productRoot?;
+    private surface?;
+    private texture?;
+    private animationFrame;
+    /**
+     * @param host 三维查看器挂载容器
+     */
+    constructor(host: HTMLElement);
+    /**
+     * 加载远程模型或创建内置演示模型
+     *
+     * @param product 已完成默认值补全的产品配置
+     * @throws 模型加载失败或找不到目标 Mesh 时抛出错误
+     */
+    loadProduct(product: NormalizedProductConfiguration): Promise<void>;
+    /**
+     * 保存并绑定二维编辑器生成的实时纹理
+     *
+     * 如果模型尚未加载，纹理会在模型加载完成后自动绑定
+     *
+     * @param texture 由二维画布创建的 CanvasTexture
+     */
+    setTexture(texture: CanvasTexture): void;
+    /** 根据当前模型包围盒恢复默认相机位置 */
+    resetView(): void;
+    /** 释放动画帧、相机控制、模型材质和 WebGLRenderer */
+    destroy(): void;
+    private addEnvironment;
+    private createDemoProduct;
+    /**
+     * 按名称查找接收实时纹理的 Mesh
+     *
+     * @throws 找不到对象或同名对象不是 Mesh 时抛出错误
+     */
+    private findSurface;
+    /**
+     * 将纹理应用到目标 Mesh 的第一个材质槽
+     *
+     * 非 MeshStandardMaterial 会被替换为基础标准材质
+     */
+    private attachTexture;
+    private fitCamera;
+    private removeProduct;
+    private resize;
+    private render;
+    private markRenderState;
+}
+//# sourceMappingURL=ProductViewer.d.ts.map

package/dist/viewer/ProductViewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProductViewer.d.ts","sourceRoot":"","sources":["../../src/viewer/ProductViewer.ts"],"names":[],"mappings":"AAAA,OAAO,EAoBL,KAAK,aAAa,EAEnB,MAAM,OAAO,CAAA;AAGd,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAA;AAEpE;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,WAAW,CAAC,CAAU;IAC9B,OAAO,CAAC,OAAO,CAAC,CAAM;IACtB,OAAO,CAAC,OAAO,CAAC,CAAe;IAC/B,OAAO,CAAC,cAAc,CAAI;IAE1B;;OAEG;IACH,YAAY,IAAI,EAAE,WAAW,EA6B5B;IAED;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBxE;IAED;;;;;;OAMG;IACH,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAKvC;IAED,wBAAwB;IACxB,SAAS,IAAI,IAAI,CAIhB;IAED,qCAAqC;IACrC,OAAO,IAAI,IAAI,CAOd;IAED,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,iBAAiB;IA4CzB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAQnB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,SAAS;IAejB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,MAAM,CAKb;IAED,OAAO,CAAC,eAAe;CAqCxB"}

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "customforge",
+  "version": "0.1.0-alpha.0",
+  "description": "A framework-agnostic browser library for live 2D-to-3D product customization",
+  "license": "Apache-2.0",
+  "private": false,
+  "publishConfig": {
+    "access": "public",
+    "tag": "alpha"
+  },
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./style.css": "./dist/style.css"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README.zh-CN.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "peerDependencies": {
+    "fabric": "^7.4.0",
+    "three": "^0.185.1"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/songshanliu/CustomForge.git"
+  },
+  "homepage": "https://github.com/songshanliu/CustomForge#readme",
+  "bugs": {
+    "url": "https://github.com/songshanliu/CustomForge/issues"
+  },
+  "keywords": [
+    "3d",
+    "fabricjs",
+    "product-customizer",
+    "threejs",
+    "web-to-print"
+  ],
+  "devDependencies": {
+    "@types/three": "^0.185.4",
+    "fabric": "^7.4.0",
+    "lucide": "^1.34.0",
+    "three": "^0.185.1",
+    "typescript": "^7.0.2",
+    "vite": "^8.2.2",
+    "vitest": "^4.1.11"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "build:lib:js": "vite build --config vite.lib.config.ts",
+    "build:lib:types": "tsc -p tsconfig.lib.json",
+    "build:lib": "pnpm build:lib:js && pnpm build:lib:types",
+    "check": "tsc -b --pretty false",
+    "test": "vitest run",
+    "preview": "vite preview",
+    "verify:package": "node scripts/verify-package.mjs",
+    "pack:local": "pnpm build:lib && pnpm verify:package && pnpm pack",
+    "release:check": "pnpm check && pnpm test && pnpm pack:local"
+  }
+}