@operato/scene-storage 10.0.0-beta.48 → 10.0.0-beta.53

package/dist/spot.d.ts

@@ -8,6 +8,7 @@ export interface SpotState extends State {
 }
 declare const Spot_base: any;
 export default class Spot extends Spot_base {
+    _singleSlotId(): string;
     state: SpotState;
     _realObject?: Spot3D;
     static placement: PlacementArchetype;

package/dist/spot.js

@@ -30,7 +30,7 @@
  */
 import { __decorate } from "tslib";
 import { ContainerAbstract, sceneComponent } from '@hatiolab/things-scene';
-import { CarrierHolder, Placeable } from '@operato/scene-base';
+import { CarrierHolder, Placeable, SingleSlotHolder } from '@operato/scene-base';
 import { Spot3D } from './spot-3d.js';
 const NATURE = {
     mutable: false,
@@ -49,7 +49,9 @@ const NATURE = {
 // `ContainerAbstract` (not `Container`) — Container = MixinHTMLElement(ContainerAbstract),
 // which forces `isHTMLElement(): true` and trips the 3D pipeline's
 // addObject DOM-skip gate. Spot is purely 3D.
-let Spot = class Spot extends CarrierHolder(Placeable(ContainerAbstract)) {
+let Spot = class Spot extends SingleSlotHolder()(CarrierHolder(Placeable(ContainerAbstract))) {
+    // SingleSlotHolder hook override — Spot 의 slot id 'pad'.
+    _singleSlotId() { return SPOT_SLOT_ID; }
     static placement = 'floor';
     static align = 'bottom';
     static defaultDepth = (_h) => 2; // a thin pad
@@ -138,6 +140,8 @@ Spot = __decorate([
     sceneComponent('spot')
 ], Spot);
 export default Spot;
+/** Spot 의 유일 virtual slot id. */
+const SPOT_SLOT_ID = 'pad';
 function resolveDepth(c) {
     const eff = c._realObject?.effectiveDepth;
     if (typeof eff === 'number' && Number.isFinite(eff))

package/dist/spot.js.map

@@ -1 +1 @@
-{"version":3,"file":"spot.js","sourceRoot":"","sources":["../src/spot.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * Spot — virtual pickup / drop zone.\n *\n * A modeling-time anchor for \"this is where things land\" — the destination\n * of a robot arm pick-and-place, the slot of an AGV stop, the staging\n * zone next to a conveyor. Spot itself does not move and does\n * not perform any logistics action; it only marks a location and accepts\n * carrier components as children.\n *\n * Visual identity:\n *   - 2D: outlined rectangle with corner \"L\" marks (so it reads as a\n *     virtual zone, not a solid object).\n *   - 3D: a thin translucent floor pad — only the floor of the conceptual\n *     box is rendered, the side walls are absent.\n *\n * Standard things-scene properties used (no component-specific extras —\n * keep the property-panel UX uniform with other components):\n *   - `fillStyle`               — pad / outline color (sole color source)\n *   - `strokeStyle`             — outline color override (defaults to fillStyle)\n *   - `lineWidth` / `lineDash`  — outline stroke style\n *   - `alpha`                   — overall transparency, framework-applied\n *   - `text` / `fontColor` / `fontSize` / `fontFamily` / `bold` / `italic`\n *                               — label rendered by the standard text pipeline\n *   - `material3d` (3D)         — metalness / roughness / castShadow / receiveShadow\n *\n * Role: `CarrierHolder` — accepts any Carrier as a child and lays it on\n * the top face of the pad (overrides default attachPointFor).\n */\n\nimport { Component, ComponentNature, ContainerAbstract, RealObject, sceneComponent } from '@hatiolab/things-scene'\nimport type { State, Material3D } from '@hatiolab/things-scene'\nimport {\n  CarrierHolder,\n  Placeable,\n  type AttachFrame,\n  type Alignment,\n  type Heights,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { Spot3D } from './spot-3d.js'\n\n/** Spot 컴포넌트 state */\nexport interface SpotState extends State {\n  // Spot has no component-specific state — it uses standard fillStyle /\n  // strokeStyle / lineWidth / alpha / text / font* / material3d.\n  material3d?: Material3D\n}\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  // No component-specific properties — fillStyle / strokeStyle / lineWidth /\n  // alpha / text / font* are framework-standard, surfaced by the property\n  // panel automatically.\n  properties: [],\n  help: 'scene/component/spot'\n}\n\n// ContainerAbstract base — Spot accepts carrier children (parcel/box/pallet/...).\n// CarrierHolder mixin only publishes the attach-point hook; the actual\n// child-list management comes from things-scene's container abstract.\n//\n// `ContainerAbstract` (not `Container`) — Container = MixinHTMLElement(ContainerAbstract),\n// which forces `isHTMLElement(): true` and trips the 3D pipeline's\n// addObject DOM-skip gate. Spot is purely 3D.\n@sceneComponent('spot')\nexport default class Spot extends CarrierHolder(Placeable(ContainerAbstract)) {\n  declare state: SpotState\n  declare _realObject?: Spot3D\n\n  static placement: PlacementArchetype = 'floor'\n  static align: Alignment = 'bottom'\n  static defaultDepth = (_h: Heights) => 2 // a thin pad\n\n  get nature(): ComponentNature {\n    return NATURE\n  }\n\n  get anchors() {\n    return []\n  }\n\n  /**\n   * 2D — outlined rectangle + corner L marks. The pad body is drawn with a\n   * fixed low alpha (0.15) on top of the user's `fillStyle` so the zone reads\n   * as virtual even when fillStyle is fully opaque. Outline + corner marks\n   * use `strokeStyle` (or fall back to `fillStyle`) at the user's `lineWidth`\n   * and `lineDash`. The text label is drawn by the framework's standard\n   * postrender pipeline using `text` / `fontColor` / `fontSize` / etc.\n   */\n  render(ctx: CanvasRenderingContext2D) {\n    const { left = 0, top = 0, width = 100, height = 100 } = this.state\n    const fillStyle = (this.state.fillStyle as string) || '#3a8fbd'\n    const strokeStyle = (this.state.strokeStyle as string) || fillStyle\n    const lineWidth = numOr(this.state.lineWidth, 1)\n    const lineDashStyle = String(this.state.lineDash ?? 'dash')\n\n    // ── Pad body (fixed-low-alpha tint of fillStyle) ───────────────────\n    ctx.save()\n    ctx.fillStyle = fillStyle\n    ctx.globalAlpha = 0.15\n    ctx.fillRect(left, top, width, height)\n    ctx.restore()\n\n    // ── Outline ────────────────────────────────────────────────────────\n    ctx.save()\n    ctx.strokeStyle = strokeStyle\n    ctx.lineWidth = lineWidth\n    applyLineDash(ctx, lineDashStyle, lineWidth)\n    ctx.strokeRect(\n      left + lineWidth / 2,\n      top + lineWidth / 2,\n      width - lineWidth,\n      height - lineWidth\n    )\n    ctx.setLineDash([])\n    ctx.restore()\n\n    // ── Corner L marks (solid, slightly heavier than outline) ──────────\n    const ml = Math.min(width, height) * 0.18\n    const cornerW = Math.max(lineWidth * 1.5, 1.5)\n    ctx.save()\n    ctx.strokeStyle = strokeStyle\n    ctx.lineWidth = cornerW\n    for (const [cx, cy, sx, sy] of [\n      [left, top, 1, 1],\n      [left + width, top, -1, 1],\n      [left + width, top + height, -1, -1],\n      [left, top + height, 1, -1]\n    ] as [number, number, number, number][]) {\n      ctx.beginPath()\n      ctx.moveTo(cx + sx * ml, cy)\n      ctx.lineTo(cx, cy)\n      ctx.lineTo(cx, cy + sy * ml)\n      ctx.stroke()\n    }\n    ctx.restore()\n  }\n\n  buildRealObject(): RealObject | undefined {\n    return new Spot3D(this)\n  }\n\n  /**\n   * Mount carriers on the TOP of the pad (Spot3D's `getAttachFrame` is\n   * already at pad-top in spot-local). Then lift the carrier by its\n   * own halfDepth so the carrier's BOTTOM rests ON the pad surface, not\n   * its volumetric center — without this lift, half the carrier would\n   * sink below the pad / floor.\n   *\n   * Reads `_realObject.effectiveDepth` first (the framework-resolved\n   * value, accounting for `static defaultDepth` and parent context),\n   * falling back to raw `state.depth` for components built before\n   * RealObject creation.\n   */\n  attachPointFor(carrier: Component): AttachFrame | null {\n    const ro = this._realObject\n    const frame = ro?.getAttachFrame?.()\n    if (!frame) return null\n    const carrierDepth = resolveDepth(carrier)\n    return {\n      attach: frame,\n      localPosition: { x: 0, y: carrierDepth / 2, z: 0 }\n    }\n  }\n}\n\nfunction resolveDepth(c: Component): number {\n  const eff = (c as any)._realObject?.effectiveDepth\n  if (typeof eff === 'number' && Number.isFinite(eff)) return eff\n  return numOr((c as any)?.state?.depth, 0)\n}\n\nfunction numOr(v: unknown, dflt: number): number {\n  return typeof v === 'number' && Number.isFinite(v) ? v : dflt\n}\n\n/**\n * Map a things-scene `lineDash` string to a Canvas dash pattern. Mirrors\n * the keys understood by things-scene's `drawer/stroke.ts` so users see\n * consistent options across components. Unknown strings fall through to\n * a plain dashed pattern instead of throwing on setLineDash.\n */\nfunction applyLineDash(ctx: CanvasRenderingContext2D, style: string, lw: number) {\n  switch (style) {\n    case 'solid':\n      ctx.setLineDash([])\n      return\n    case 'round-dot':\n      ctx.setLineDash([0.1, lw * 2])\n      ctx.lineCap = 'round'\n      return\n    case 'square-dot':\n      ctx.setLineDash([lw, lw])\n      return\n    case 'long-dash':\n      ctx.setLineDash([lw * 6, lw * 3])\n      return\n    case 'dash-dot':\n      ctx.setLineDash([lw * 4, lw * 2, lw, lw * 2])\n      return\n    case 'dash':\n    default:\n      ctx.setLineDash([lw * 4, lw * 1.5])\n      return\n  }\n}\n"]}
+{"version":3,"file":"spot.js","sourceRoot":"","sources":["../src/spot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;;AAEH,OAAO,EAA8B,iBAAiB,EAAc,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAElH,OAAO,EACL,aAAa,EACb,SAAS,EACT,gBAAgB,EAKjB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AASrC,MAAM,MAAM,GAAoB;IAC9B,OAAO,EAAE,KAAK;IACd,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,2EAA2E;IAC3E,wEAAwE;IACxE,uBAAuB;IACvB,UAAU,EAAE,EAAE;IACd,IAAI,EAAE,sBAAsB;CAC7B,CAAA;AAED,kFAAkF;AAClF,uEAAuE;AACvE,sEAAsE;AACtE,EAAE;AACF,2FAA2F;AAC3F,mEAAmE;AACnE,8CAA8C;AAE/B,IAAM,IAAI,GAAV,MAAM,IAAK,SAAQ,gBAAgB,EAAE,CAClD,aAAa,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAC5C;IACC,yDAAyD;IACzD,aAAa,KAAK,OAAO,YAAY,CAAA,CAAC,CAAC;IAIvC,MAAM,CAAC,SAAS,GAAuB,OAAO,CAAA;IAC9C,MAAM,CAAC,KAAK,GAAc,QAAQ,CAAA;IAClC,MAAM,CAAC,YAAY,GAAG,CAAC,EAAW,EAAE,EAAE,CAAC,CAAC,CAAA,CAAC,aAAa;IAEtD,IAAI,MAAM;QACR,OAAO,MAAM,CAAA;IACf,CAAC;IAED,IAAI,OAAO;QACT,OAAO,EAAE,CAAA;IACX,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,GAA6B;QAClC,MAAM,EAAE,IAAI,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,EAAE,KAAK,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAA;QACnE,MAAM,SAAS,GAAI,IAAI,CAAC,KAAK,CAAC,SAAoB,IAAI,SAAS,CAAA;QAC/D,MAAM,WAAW,GAAI,IAAI,CAAC,KAAK,CAAC,WAAsB,IAAI,SAAS,CAAA;QACnE,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAA;QAChD,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,MAAM,CAAC,CAAA;QAE3D,sEAAsE;QACtE,GAAG,CAAC,IAAI,EAAE,CAAA;QACV,GAAG,CAAC,SAAS,GAAG,SAAS,CAAA;QACzB,GAAG,CAAC,WAAW,GAAG,IAAI,CAAA;QACtB,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAA;QACtC,GAAG,CAAC,OAAO,EAAE,CAAA;QAEb,sEAAsE;QACtE,GAAG,CAAC,IAAI,EAAE,CAAA;QACV,GAAG,CAAC,WAAW,GAAG,WAAW,CAAA;QAC7B,GAAG,CAAC,SAAS,GAAG,SAAS,CAAA;QACzB,aAAa,CAAC,GAAG,EAAE,aAAa,EAAE,SAAS,CAAC,CAAA;QAC5C,GAAG,CAAC,UAAU,CACZ,IAAI,GAAG,SAAS,GAAG,CAAC,EACpB,GAAG,GAAG,SAAS,GAAG,CAAC,EACnB,KAAK,GAAG,SAAS,EACjB,MAAM,GAAG,SAAS,CACnB,CAAA;QACD,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;QACnB,GAAG,CAAC,OAAO,EAAE,CAAA;QAEb,sEAAsE;QACtE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,GAAG,EAAE,GAAG,CAAC,CAAA;QAC9C,GAAG,CAAC,IAAI,EAAE,CAAA;QACV,GAAG,CAAC,WAAW,GAAG,WAAW,CAAA;QAC7B,GAAG,CAAC,SAAS,GAAG,OAAO,CAAA;QACvB,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,IAAI;YAC7B,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC,IAAI,GAAG,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAC1B,CAAC,IAAI,GAAG,KAAK,EAAE,GAAG,GAAG,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACpC,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;SACU,EAAE,CAAC;YACxC,GAAG,CAAC,SAAS,EAAE,CAAA;YACf,GAAG,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAA;YAC5B,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;YAClB,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAA;YAC5B,GAAG,CAAC,MAAM,EAAE,CAAA;QACd,CAAC;QACD,GAAG,CAAC,OAAO,EAAE,CAAA;IACf,CAAC;IAED,eAAe;QACb,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED;;;;;;;;;;;OAWG;IACH,cAAc,CAAC,OAAkB;QAC/B,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAA;QAC3B,MAAM,KAAK,GAAG,EAAE,EAAE,cAAc,EAAE,EAAE,CAAA;QACpC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAA;QACvB,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;QAC1C,OAAO;YACL,MAAM,EAAE,KAAK;YACb,aAAa,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,YAAY,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE;SACnD,CAAA;IACH,CAAC;;AAtGkB,IAAI;IADxB,cAAc,CAAC,MAAM,CAAC;GACF,IAAI,CA6GxB;eA7GoB,IAAI;AA+GzB,iCAAiC;AACjC,MAAM,YAAY,GAAG,KAAK,CAAA;AAE1B,SAAS,YAAY,CAAC,CAAY;IAChC,MAAM,GAAG,GAAI,CAAS,CAAC,WAAW,EAAE,cAAc,CAAA;IAClD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAA;IAC/D,OAAO,KAAK,CAAE,CAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;AAC3C,CAAC;AAED,SAAS,KAAK,CAAC,CAAU,EAAE,IAAY;IACrC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAC/D,CAAC;AAED;;;;;GAKG;AACH,SAAS,aAAa,CAAC,GAA6B,EAAE,KAAa,EAAE,EAAU;IAC7E,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO;YACV,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;YACnB,OAAM;QACR,KAAK,WAAW;YACd,GAAG,CAAC,WAAW,CAAC,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;YAC9B,GAAG,CAAC,OAAO,GAAG,OAAO,CAAA;YACrB,OAAM;QACR,KAAK,YAAY;YACf,GAAG,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;YACzB,OAAM;QACR,KAAK,WAAW;YACd,GAAG,CAAC,WAAW,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;YACjC,OAAM;QACR,KAAK,UAAU;YACb,GAAG,CAAC,WAAW,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;YAC7C,OAAM;QACR,KAAK,MAAM,CAAC;QACZ;YACE,GAAG,CAAC,WAAW,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,GAAG,CAAC,CAAC,CAAA;YACnC,OAAM;IACV,CAAC;AACH,CAAC","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * Spot — virtual pickup / drop zone.\n *\n * A modeling-time anchor for \"this is where things land\" — the destination\n * of a robot arm pick-and-place, the slot of an AGV stop, the staging\n * zone next to a conveyor. Spot itself does not move and does\n * not perform any logistics action; it only marks a location and accepts\n * carrier components as children.\n *\n * Visual identity:\n *   - 2D: outlined rectangle with corner \"L\" marks (so it reads as a\n *     virtual zone, not a solid object).\n *   - 3D: a thin translucent floor pad — only the floor of the conceptual\n *     box is rendered, the side walls are absent.\n *\n * Standard things-scene properties used (no component-specific extras —\n * keep the property-panel UX uniform with other components):\n *   - `fillStyle`               — pad / outline color (sole color source)\n *   - `strokeStyle`             — outline color override (defaults to fillStyle)\n *   - `lineWidth` / `lineDash`  — outline stroke style\n *   - `alpha`                   — overall transparency, framework-applied\n *   - `text` / `fontColor` / `fontSize` / `fontFamily` / `bold` / `italic`\n *                               — label rendered by the standard text pipeline\n *   - `material3d` (3D)         — metalness / roughness / castShadow / receiveShadow\n *\n * Role: `CarrierHolder` — accepts any Carrier as a child and lays it on\n * the top face of the pad (overrides default attachPointFor).\n */\n\nimport { Component, ComponentNature, ContainerAbstract, RealObject, sceneComponent } from '@hatiolab/things-scene'\nimport type { State, Material3D } from '@hatiolab/things-scene'\nimport {\n  CarrierHolder,\n  Placeable,\n  SingleSlotHolder,\n  type AttachFrame,\n  type Alignment,\n  type Heights,\n  type PlacementArchetype\n} from '@operato/scene-base'\n\nimport { Spot3D } from './spot-3d.js'\n\n/** Spot 컴포넌트 state */\nexport interface SpotState extends State {\n  // Spot has no component-specific state — it uses standard fillStyle /\n  // strokeStyle / lineWidth / alpha / text / font* / material3d.\n  material3d?: Material3D\n}\n\nconst NATURE: ComponentNature = {\n  mutable: false,\n  resizable: true,\n  rotatable: true,\n  // No component-specific properties — fillStyle / strokeStyle / lineWidth /\n  // alpha / text / font* are framework-standard, surfaced by the property\n  // panel automatically.\n  properties: [],\n  help: 'scene/component/spot'\n}\n\n// ContainerAbstract base — Spot accepts carrier children (parcel/box/pallet/...).\n// CarrierHolder mixin only publishes the attach-point hook; the actual\n// child-list management comes from things-scene's container abstract.\n//\n// `ContainerAbstract` (not `Container`) — Container = MixinHTMLElement(ContainerAbstract),\n// which forces `isHTMLElement(): true` and trips the 3D pipeline's\n// addObject DOM-skip gate. Spot is purely 3D.\n@sceneComponent('spot')\nexport default class Spot extends SingleSlotHolder()(\n  CarrierHolder(Placeable(ContainerAbstract))\n) {\n  // SingleSlotHolder hook override — Spot 의 slot id 'pad'.\n  _singleSlotId() { return SPOT_SLOT_ID }\n  declare state: SpotState\n  declare _realObject?: Spot3D\n\n  static placement: PlacementArchetype = 'floor'\n  static align: Alignment = 'bottom'\n  static defaultDepth = (_h: Heights) => 2 // a thin pad\n\n  get nature(): ComponentNature {\n    return NATURE\n  }\n\n  get anchors() {\n    return []\n  }\n\n  /**\n   * 2D — outlined rectangle + corner L marks. The pad body is drawn with a\n   * fixed low alpha (0.15) on top of the user's `fillStyle` so the zone reads\n   * as virtual even when fillStyle is fully opaque. Outline + corner marks\n   * use `strokeStyle` (or fall back to `fillStyle`) at the user's `lineWidth`\n   * and `lineDash`. The text label is drawn by the framework's standard\n   * postrender pipeline using `text` / `fontColor` / `fontSize` / etc.\n   */\n  render(ctx: CanvasRenderingContext2D) {\n    const { left = 0, top = 0, width = 100, height = 100 } = this.state\n    const fillStyle = (this.state.fillStyle as string) || '#3a8fbd'\n    const strokeStyle = (this.state.strokeStyle as string) || fillStyle\n    const lineWidth = numOr(this.state.lineWidth, 1)\n    const lineDashStyle = String(this.state.lineDash ?? 'dash')\n\n    // ── Pad body (fixed-low-alpha tint of fillStyle) ───────────────────\n    ctx.save()\n    ctx.fillStyle = fillStyle\n    ctx.globalAlpha = 0.15\n    ctx.fillRect(left, top, width, height)\n    ctx.restore()\n\n    // ── Outline ────────────────────────────────────────────────────────\n    ctx.save()\n    ctx.strokeStyle = strokeStyle\n    ctx.lineWidth = lineWidth\n    applyLineDash(ctx, lineDashStyle, lineWidth)\n    ctx.strokeRect(\n      left + lineWidth / 2,\n      top + lineWidth / 2,\n      width - lineWidth,\n      height - lineWidth\n    )\n    ctx.setLineDash([])\n    ctx.restore()\n\n    // ── Corner L marks (solid, slightly heavier than outline) ──────────\n    const ml = Math.min(width, height) * 0.18\n    const cornerW = Math.max(lineWidth * 1.5, 1.5)\n    ctx.save()\n    ctx.strokeStyle = strokeStyle\n    ctx.lineWidth = cornerW\n    for (const [cx, cy, sx, sy] of [\n      [left, top, 1, 1],\n      [left + width, top, -1, 1],\n      [left + width, top + height, -1, -1],\n      [left, top + height, 1, -1]\n    ] as [number, number, number, number][]) {\n      ctx.beginPath()\n      ctx.moveTo(cx + sx * ml, cy)\n      ctx.lineTo(cx, cy)\n      ctx.lineTo(cx, cy + sy * ml)\n      ctx.stroke()\n    }\n    ctx.restore()\n  }\n\n  buildRealObject(): RealObject | undefined {\n    return new Spot3D(this)\n  }\n\n  /**\n   * Mount carriers on the TOP of the pad (Spot3D's `getAttachFrame` is\n   * already at pad-top in spot-local). Then lift the carrier by its\n   * own halfDepth so the carrier's BOTTOM rests ON the pad surface, not\n   * its volumetric center — without this lift, half the carrier would\n   * sink below the pad / floor.\n   *\n   * Reads `_realObject.effectiveDepth` first (the framework-resolved\n   * value, accounting for `static defaultDepth` and parent context),\n   * falling back to raw `state.depth` for components built before\n   * RealObject creation.\n   */\n  attachPointFor(carrier: Component): AttachFrame | null {\n    const ro = this._realObject\n    const frame = ro?.getAttachFrame?.()\n    if (!frame) return null\n    const carrierDepth = resolveDepth(carrier)\n    return {\n      attach: frame,\n      localPosition: { x: 0, y: carrierDepth / 2, z: 0 }\n    }\n  }\n\n  // SlottedHolder duck (slotIds / hasCarrierAt / canReceiveAt / occupiedSlotIds /\n  // emptySlotIds / obtainCarrier / receiveAt / accept / receive / slotTargetAt /\n  // getSlotAttachObject3d) — SingleSlotHolder mixin 제공.\n  // virtual location handoff buffer 동작: receiveAt 가 reparent (components +\n  // 3D) 로 carrier 를 자식으로 유지 → 다음 mover 가 obtainCarrier 로 승계.\n}\n\n/** Spot 의 유일 virtual slot id. */\nconst SPOT_SLOT_ID = 'pad'\n\nfunction resolveDepth(c: Component): number {\n  const eff = (c as any)._realObject?.effectiveDepth\n  if (typeof eff === 'number' && Number.isFinite(eff)) return eff\n  return numOr((c as any)?.state?.depth, 0)\n}\n\nfunction numOr(v: unknown, dflt: number): number {\n  return typeof v === 'number' && Number.isFinite(v) ? v : dflt\n}\n\n/**\n * Map a things-scene `lineDash` string to a Canvas dash pattern. Mirrors\n * the keys understood by things-scene's `drawer/stroke.ts` so users see\n * consistent options across components. Unknown strings fall through to\n * a plain dashed pattern instead of throwing on setLineDash.\n */\nfunction applyLineDash(ctx: CanvasRenderingContext2D, style: string, lw: number) {\n  switch (style) {\n    case 'solid':\n      ctx.setLineDash([])\n      return\n    case 'round-dot':\n      ctx.setLineDash([0.1, lw * 2])\n      ctx.lineCap = 'round'\n      return\n    case 'square-dot':\n      ctx.setLineDash([lw, lw])\n      return\n    case 'long-dash':\n      ctx.setLineDash([lw * 6, lw * 3])\n      return\n    case 'dash-dot':\n      ctx.setLineDash([lw * 4, lw * 2, lw, lw * 2])\n      return\n    case 'dash':\n    default:\n      ctx.setLineDash([lw * 4, lw * 1.5])\n      return\n  }\n}\n"]}

package/dist/stockpile-3d.d.ts

@@ -0,0 +1,55 @@
+import * as THREE from 'three';
+import { RealObjectGroup } from '@hatiolab/things-scene';
+export declare class Stockpile3D extends RealObjectGroup {
+    private _carriersGroup?;
+    private _padMesh?;
+    /** pad 의 외곽선 — strokeStyle 표현 (2D dashed outline 의 3D 대응). */
+    private _padOutline?;
+    /** record.id → 해당 carrier mesh 매핑 — popup anchor / tether 의 대상으로 사용. */
+    private _meshByRecordId;
+    /** Legend 매핑된 색을 material 로 캐시 — 같은 색 record 들은 material 공유 (drawcall ↓). */
+    private _materialByColor;
+    private _getMaterialForColor;
+    private _disposeMaterialCache;
+    build(): void;
+    update(): void;
+    /**
+     * carrier attach point.
+     *   - slotId 가 record.id 와 매칭되면 그 record 의 mesh 반환 → popup tether 가 정확히
+     *     해당 stock 에 연결.
+     *   - 아니면 pad 반환 (단일 'pile' slot, mover place 의 default anchor).
+     */
+    getAttachFrame(slotId?: string): THREE.Object3D | undefined;
+    /** state.fillStyle → THREE.Color. 잘못된 값/없으면 default. capacity 점유율에 따른
+     *  색 변경은 강요하지 않음 — 필요하면 사용자가 mapping(eval)으로 fillStyle 을 조정. */
+    private _padColor;
+    /** state.strokeStyle → THREE.Color (pad 외곽선 색). 미설정 시 fillStyle 따라가되
+     *  대비 위해 약간 어둡게 */
+    private _strokeColor;
+    private _applyStrokeColor;
+    /** state.fillStyle 변경 즉시 반영 — pad material 의 color + emissive 갱신. */
+    private _applyPadColor;
+    private _rebuildCarriers;
+    /** record.id 로 해당 carrier mesh 직접 조회 — popup tether anchor 용. */
+    getMeshByRecordId(recordId: string): THREE.Mesh | undefined;
+    /**
+     * stackPattern 별 각 carrier 의 local 좌표(영역 중심 기준). y 는 pad 위에 쌓이는
+     * 높이(cd 단위), x/z 는 영역 평면 위 분포.
+     */
+    private _computeStackPositions;
+    /** carrierPreset 별 geometry. drum 은 cylinder, 나머지는 box. */
+    private _carrierGeometry;
+    /**
+     * state.alpha 변경 시 pad + carriers 의 material opacity 즉시 반영.
+     * pad 는 원래 0.55 base opacity 위에 alpha 곱 (영역 표시가 너무 진해지지 않도록).
+     * carriers 는 alpha 그대로 (단순한 곱은 fully opaque 이 1, 반투명이 0).
+     */
+    updateAlpha(): void;
+    updateDimension(): void;
+    /**
+     * state 변경 시 즉시 3D 갱신 — property panel 의 수정이 바로 반영되도록.
+     *   - width/height → pad geometry 재생성 + carriers 재계산 (updateDimension)
+     *   - 적치/외형 관련 키 → carriers 만 재계산 (_rebuildCarriers)
+     */
+    onchange(after: Record<string, unknown>, before: Record<string, unknown>): void;
+}

package/dist/stockpile-3d.js

@@ -0,0 +1,387 @@
+/*
+ * Copyright © HatioLab Inc. All rights reserved.
+ *
+ * Stockpile3D — 평치 영역의 3D 시각화.
+ *
+ *   - floor pad (얇은 box, 영역 footprint).
+ *   - records.length 만큼 가상 carrier mesh 를 *_stackPattern_* 으로 자동 배치.
+ *   - mesh geometry / material 은 *_carrierPreset_* 별.
+ *
+ * 핵심 — 실제 carrier 컴포넌트를 자식으로 두지 않고 *_가상 mesh_* 만 그려서 다수
+ * 적치를 가볍게 표현. records 변경 시 update() 가 호출되어 mesh 가 재배치된다.
+ */
+import * as THREE from 'three';
+import { RealObjectGroup } from '@hatiolab/things-scene';
+const PAD_DEPTH = 2;
+/** carrierPreset 별 default 색 (state.carrierWidth/Height/Depth 미지정 시 크기와 함께). */
+const PRESET_COLOR = {
+    box: 0xb87333, // kraft brown
+    pallet: 0x8b6f47, // 짙은 나무
+    drum: 0x556679, // 금속/blue-grey
+    sack: 0xd4c89a, // beige 천
+    crate: 0x9a7548, // 나무 상자
+    bale: 0xa89968 // 압축 베일
+};
+const PRESET_DEFAULT_SIZE = {
+    box: { w: 26, h: 26, d: 20 },
+    pallet: { w: 40, h: 30, d: 15 },
+    drum: { w: 24, h: 24, d: 30 },
+    sack: { w: 30, h: 28, d: 18 },
+    crate: { w: 30, h: 30, d: 22 },
+    bale: { w: 32, h: 30, d: 18 }
+};
+export class Stockpile3D extends RealObjectGroup {
+    _carriersGroup;
+    _padMesh;
+    /** pad 의 외곽선 — strokeStyle 표현 (2D dashed outline 의 3D 대응). */
+    _padOutline;
+    /** record.id → 해당 carrier mesh 매핑 — popup anchor / tether 의 대상으로 사용. */
+    _meshByRecordId = new Map();
+    /** Legend 매핑된 색을 material 로 캐시 — 같은 색 record 들은 material 공유 (drawcall ↓). */
+    _materialByColor = new Map();
+    _getMaterialForColor(colorHex) {
+        let m = this._materialByColor.get(colorHex);
+        if (!m) {
+            m = new THREE.MeshStandardMaterial({ color: colorHex, roughness: 0.7 });
+            this._materialByColor.set(colorHex, m);
+        }
+        return m;
+    }
+    _disposeMaterialCache() {
+        for (const m of this._materialByColor.values())
+            m.dispose();
+        this._materialByColor.clear();
+    }
+    build() {
+        super.build();
+        const state = this.component.state;
+        const w = state.width ?? 100;
+        const h = state.height ?? 100;
+        // ── floor pad — 영역 표시 (얇은 box) ──────────────────────────────
+        const padGeom = new THREE.BoxGeometry(w, PAD_DEPTH, h);
+        const padColor = this._padColor();
+        const padMat = new THREE.MeshStandardMaterial({
+            color: padColor, roughness: 0.85, transparent: true, opacity: 0.55,
+            emissive: padColor, emissiveIntensity: 0.05
+        });
+        this._padMesh = new THREE.Mesh(padGeom, padMat);
+        this._padMesh.position.y = PAD_DEPTH / 2;
+        this._padMesh.receiveShadow = true;
+        this.object3d.add(this._padMesh);
+        // pad 외곽선 — strokeStyle 3D 표현. 2D 의 dashed outline 과 같은 의도.
+        const outlineColor = this._strokeColor();
+        const outlineMat = new THREE.LineBasicMaterial({ color: outlineColor });
+        this._padOutline = new THREE.LineSegments(new THREE.EdgesGeometry(padGeom), outlineMat);
+        this._padOutline.position.y = PAD_DEPTH / 2;
+        this.object3d.add(this._padOutline);
+        // ── carriers group — records 기반 자동 적치 ─────────────────────
+        this._carriersGroup = new THREE.Group();
+        this._carriersGroup.position.y = PAD_DEPTH;
+        this.object3d.add(this._carriersGroup);
+        this._rebuildCarriers();
+    }
+    update() {
+        super.update();
+        this._rebuildCarriers();
+    }
+    /**
+     * carrier attach point.
+     *   - slotId 가 record.id 와 매칭되면 그 record 의 mesh 반환 → popup tether 가 정확히
+     *     해당 stock 에 연결.
+     *   - 아니면 pad 반환 (단일 'pile' slot, mover place 의 default anchor).
+     */
+    getAttachFrame(slotId) {
+        if (slotId) {
+            const mesh = this._meshByRecordId.get(slotId);
+            if (mesh)
+                return mesh;
+        }
+        return this._padMesh;
+    }
+    /** state.fillStyle → THREE.Color. 잘못된 값/없으면 default. capacity 점유율에 따른
+     *  색 변경은 강요하지 않음 — 필요하면 사용자가 mapping(eval)으로 fillStyle 을 조정. */
+    _padColor() {
+        const raw = this.component.state?.fillStyle;
+        if (typeof raw === 'string' && raw.length > 0) {
+            try {
+                return new THREE.Color(raw);
+            }
+            catch { /* fallthrough */ }
+        }
+        return new THREE.Color(0xc89c5c);
+    }
+    /** state.strokeStyle → THREE.Color (pad 외곽선 색). 미설정 시 fillStyle 따라가되
+     *  대비 위해 약간 어둡게 */
+    _strokeColor() {
+        const raw = this.component.state?.strokeStyle;
+        if (typeof raw === 'string' && raw.length > 0) {
+            try {
+                return new THREE.Color(raw);
+            }
+            catch { /* fallthrough */ }
+        }
+        return this._padColor().clone().multiplyScalar(0.6);
+    }
+    _applyStrokeColor() {
+        if (!this._padOutline)
+            return;
+        const m = this._padOutline.material;
+        m.color.copy(this._strokeColor());
+        m.needsUpdate = true;
+    }
+    /** state.fillStyle 변경 즉시 반영 — pad material 의 color + emissive 갱신. */
+    _applyPadColor() {
+        if (!this._padMesh)
+            return;
+        const m = this._padMesh.material;
+        const c = this._padColor();
+        m.color.copy(c);
+        m.emissive.copy(c);
+        m.needsUpdate = true;
+    }
+    _rebuildCarriers() {
+        const g = this._carriersGroup;
+        if (!g)
+            return;
+        // 기존 mesh 모두 제거 (geometry/material 은 공유돼 dispose 안 함)
+        while (g.children.length > 0)
+            g.remove(g.children[0]);
+        const stockpile = this.component;
+        const count = stockpile.records.length;
+        if (count === 0)
+            return;
+        const state = stockpile.state;
+        const areaW = state.width ?? 100;
+        const areaH = state.height ?? 100;
+        const pattern = state.stackPattern ?? 'row';
+        const preset = state.carrierPreset ?? 'box';
+        // carrier 크기 — 명시값 우선, 없으면 preset default
+        const def = PRESET_DEFAULT_SIZE[preset] ?? PRESET_DEFAULT_SIZE.box;
+        const cw = state.carrierWidth ?? def.w;
+        const ch = state.carrierHeight ?? def.h;
+        const cd = state.carrierDepth ?? def.d;
+        const gap = state.carrierGap ?? 10; // 평면(xz) cell 간격 — 0 이면 딱 붙음. carrier 크기 대비 충분히 분리되도록 default 10.
+        const geom = this._carrierGeometry(preset, cw, ch, cd);
+        // record 별로 색이 다를 수 있어(Legend 매핑) material 을 record 별로 생성.
+        // 같은 색은 material 캐시로 공유해 dispose 비용 / drawcall 최적화.
+        const presetDefaultColor = PRESET_COLOR[preset] ?? PRESET_COLOR.box;
+        this._disposeMaterialCache();
+        const resolveColor = (record) => {
+            const legendColor = stockpile.resolveLegendColor?.(record);
+            if (typeof legendColor === 'string' && legendColor.length > 0) {
+                try {
+                    return new THREE.Color(legendColor).getHex();
+                }
+                catch { /* fallthrough */ }
+            }
+            return presetDefaultColor;
+        };
+        const positions = this._computeStackPositions(pattern, count, areaW, areaH, cw, ch, cd, gap, state.stackHeightLimit);
+        this._meshByRecordId.clear();
+        const records = stockpile.records;
+        for (let i = 0; i < positions.length; i++) {
+            const p = positions[i];
+            const record = records[i];
+            const colorHex = resolveColor(record);
+            const mat = this._getMaterialForColor(colorHex);
+            const mesh = new THREE.Mesh(geom, mat);
+            mesh.position.set(p.x, p.y, p.z);
+            mesh.castShadow = true;
+            mesh.receiveShadow = true;
+            // raycast hit → record 식별을 위해 userData 에 recordId 저장 + Map 갱신.
+            const rid = records[i]?.id;
+            if (rid != null) {
+                mesh.userData.recordId = String(rid);
+                this._meshByRecordId.set(String(rid), mesh);
+            }
+            g.add(mesh);
+        }
+    }
+    /** record.id 로 해당 carrier mesh 직접 조회 — popup tether anchor 용. */
+    getMeshByRecordId(recordId) {
+        return this._meshByRecordId.get(recordId);
+    }
+    /**
+     * stackPattern 별 각 carrier 의 local 좌표(영역 중심 기준). y 는 pad 위에 쌓이는
+     * 높이(cd 단위), x/z 는 영역 평면 위 분포.
+     */
+    _computeStackPositions(pattern, count, areaW, areaH, cw, ch, cd, gap, heightLimit) {
+        const out = [];
+        // column — 한 자리에 수직 적층
+        if (pattern === 'column') {
+            const layers = heightLimit ?? count;
+            for (let i = 0; i < count; i++) {
+                const layer = Math.min(i, layers - 1);
+                out.push({ x: 0, y: layer * cd + cd / 2, z: 0 });
+            }
+            return out;
+        }
+        // 격자 cell — 행/열 수. cell stride = carrier + gap (인접 carrier 사이 분리).
+        const stridX = cw + gap;
+        const stridZ = ch + gap;
+        const cols = Math.max(1, Math.floor((areaW + gap) / stridX));
+        const rows = Math.max(1, Math.floor((areaH + gap) / stridZ));
+        const cellsPerLayer = cols * rows;
+        // pyramid — 위로 갈수록 행/열 -1 씩 (사다리꼴)
+        if (pattern === 'pyramid') {
+            let remaining = count;
+            let layer = 0;
+            while (remaining > 0) {
+                const lcols = Math.max(1, cols - layer);
+                const lrows = Math.max(1, rows - layer);
+                const cellsThisLayer = lcols * lrows;
+                const take = Math.min(remaining, cellsThisLayer);
+                for (let i = 0; i < take; i++) {
+                    const c = i % lcols;
+                    const r = Math.floor(i / lcols);
+                    // 가운데 정렬 — 줄어든 만큼 offset
+                    const offsetCol = (cols - lcols) / 2;
+                    const offsetRow = (rows - lrows) / 2;
+                    const x = -areaW / 2 + (c + offsetCol + 0.5) * stridX;
+                    const z = -areaH / 2 + (r + offsetRow + 0.5) * stridZ;
+                    out.push({ x, y: layer * cd + cd / 2, z });
+                }
+                remaining -= take;
+                layer++;
+                if (lcols === 1 && lrows === 1) {
+                    // 정상에 도달 — 남은 건 column 처럼 위로
+                    for (let i = 0; i < remaining; i++) {
+                        out.push({ x: 0, y: (layer + i) * cd + cd / 2, z: 0 });
+                    }
+                    break;
+                }
+                if (heightLimit && layer >= heightLimit)
+                    break;
+            }
+            return out;
+        }
+        // pile — 자연 더미. row 와 비슷하되 가장자리는 약간 옆으로 흘러내림 효과
+        // (간단 구현 — 단마다 약간 random offset).
+        if (pattern === 'pile') {
+            // pseudo-random (인덱스 기반, deterministic)
+            const rng = (i) => ((Math.sin(i * 12.9898) * 43758.5453) % 1 + 1) % 1;
+            for (let i = 0; i < count; i++) {
+                const layer = Math.floor(i / cellsPerLayer);
+                const idx = i % cellsPerLayer;
+                const c = idx % cols;
+                const r = Math.floor(idx / cols);
+                const jitterX = (rng(i * 2) - 0.5) * cw * 0.2;
+                const jitterZ = (rng(i * 2 + 1) - 0.5) * ch * 0.2;
+                const x = -areaW / 2 + (c + 0.5) * stridX + jitterX;
+                const z = -areaH / 2 + (r + 0.5) * stridZ + jitterZ;
+                out.push({ x, y: layer * cd + cd / 2, z });
+                if (heightLimit && layer >= heightLimit - 1 && idx === cellsPerLayer - 1)
+                    break;
+            }
+            return out;
+        }
+        // row (default) / staggered — 격자 적층
+        for (let i = 0; i < count; i++) {
+            const layer = Math.floor(i / cellsPerLayer);
+            if (heightLimit && layer >= heightLimit)
+                break;
+            const idx = i % cellsPerLayer;
+            const c = idx % cols;
+            const r = Math.floor(idx / cols);
+            let x = -areaW / 2 + (c + 0.5) * stridX;
+            const z = -areaH / 2 + (r + 0.5) * stridZ;
+            // staggered — 홀수 layer 는 1/2 cell offset (벽돌식)
+            if (pattern === 'staggered' && layer % 2 === 1) {
+                x += stridX / 2;
+            }
+            out.push({ x, y: layer * cd + cd / 2, z });
+        }
+        return out;
+    }
+    /** carrierPreset 별 geometry. drum 은 cylinder, 나머지는 box. */
+    _carrierGeometry(preset, w, h, d) {
+        if (preset === 'drum') {
+            const radius = Math.min(w, h) / 2;
+            return new THREE.CylinderGeometry(radius, radius, d, 16);
+        }
+        // sack/bale — 약간 작게 (자연스러운 형태)
+        if (preset === 'sack' || preset === 'bale') {
+            return new THREE.BoxGeometry(w * 0.92, d * 0.92, h * 0.92);
+        }
+        return new THREE.BoxGeometry(w, d, h);
+    }
+    /**
+     * state.alpha 변경 시 pad + carriers 의 material opacity 즉시 반영.
+     * pad 는 원래 0.55 base opacity 위에 alpha 곱 (영역 표시가 너무 진해지지 않도록).
+     * carriers 는 alpha 그대로 (단순한 곱은 fully opaque 이 1, 반투명이 0).
+     */
+    updateAlpha() {
+        const state = this.component.state;
+        const alpha = typeof state.alpha === 'number' ? state.alpha : 1;
+        if (this._padMesh) {
+            const m = this._padMesh.material;
+            m.opacity = 0.55 * alpha;
+            m.transparent = m.opacity < 1;
+            m.needsUpdate = true;
+        }
+        if (this._carriersGroup) {
+            for (const child of this._carriersGroup.children) {
+                const mesh = child;
+                const m = mesh.material;
+                if (!m)
+                    continue;
+                m.opacity = alpha;
+                m.transparent = alpha < 1;
+                m.needsUpdate = true;
+            }
+        }
+    }
+    updateDimension() {
+        // width/height 변경 시 pad geometry + outline + carriers 재계산
+        if (this._padMesh) {
+            const state = this.component.state;
+            const w = state.width ?? 100;
+            const h = state.height ?? 100;
+            this._padMesh.geometry.dispose();
+            this._padMesh.geometry = new THREE.BoxGeometry(w, PAD_DEPTH, h);
+            if (this._padOutline) {
+                this._padOutline.geometry.dispose();
+                this._padOutline.geometry = new THREE.EdgesGeometry(this._padMesh.geometry);
+            }
+        }
+        this._rebuildCarriers();
+    }
+    /**
+     * state 변경 시 즉시 3D 갱신 — property panel 의 수정이 바로 반영되도록.
+     *   - width/height → pad geometry 재생성 + carriers 재계산 (updateDimension)
+     *   - 적치/외형 관련 키 → carriers 만 재계산 (_rebuildCarriers)
+     */
+    onchange(after, before) {
+        if ('width' in after || 'height' in after) {
+            this.updateDimension();
+            return;
+        }
+        if ('alpha' in after) {
+            this.updateAlpha();
+            return;
+        }
+        if ('fillStyle' in after) {
+            this._applyPadColor();
+            // fillStyle 변경 시 strokeStyle 미설정이면 outline default 도 같이 갱신
+            if (this.component.state.strokeStyle == null)
+                this._applyStrokeColor();
+            return;
+        }
+        if ('strokeStyle' in after) {
+            this._applyStrokeColor();
+            return;
+        }
+        const rebuildKeys = [
+            'data',
+            'stackPattern', 'carrierPreset',
+            'carrierWidth', 'carrierHeight', 'carrierDepth', 'carrierGap',
+            'capacity', 'stackHeightLimit', 'pickPolicy'
+        ];
+        if (rebuildKeys.some(k => k in after)) {
+            this._rebuildCarriers();
+            return;
+        }
+        super.onchange?.(after, before);
+    }
+}
+//# sourceMappingURL=stockpile-3d.js.map

package/dist/stockpile-3d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stockpile-3d.js","sourceRoot":"","sources":["../src/stockpile-3d.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n *\n * Stockpile3D — 평치 영역의 3D 시각화.\n *\n *   - floor pad (얇은 box, 영역 footprint).\n *   - records.length 만큼 가상 carrier mesh 를 *_stackPattern_* 으로 자동 배치.\n *   - mesh geometry / material 은 *_carrierPreset_* 별.\n *\n * 핵심 — 실제 carrier 컴포넌트를 자식으로 두지 않고 *_가상 mesh_* 만 그려서 다수\n * 적치를 가볍게 표현. records 변경 시 update() 가 호출되어 mesh 가 재배치된다.\n */\n\nimport * as THREE from 'three'\nimport { RealObjectGroup } from '@hatiolab/things-scene'\n\nimport type Stockpile from './stockpile.js'\nimport type { StackPattern, CarrierPreset } from './stockpile.js'\n\nconst PAD_DEPTH = 2\n\n/** carrierPreset 별 default 색 (state.carrierWidth/Height/Depth 미지정 시 크기와 함께). */\nconst PRESET_COLOR: Record<CarrierPreset, number> = {\n  box: 0xb87333,      // kraft brown\n  pallet: 0x8b6f47,   // 짙은 나무\n  drum: 0x556679,     // 금속/blue-grey\n  sack: 0xd4c89a,     // beige 천\n  crate: 0x9a7548,    // 나무 상자\n  bale: 0xa89968      // 압축 베일\n}\n\nconst PRESET_DEFAULT_SIZE: Record<CarrierPreset, { w: number; h: number; d: number }> = {\n  box: { w: 26, h: 26, d: 20 },\n  pallet: { w: 40, h: 30, d: 15 },\n  drum: { w: 24, h: 24, d: 30 },\n  sack: { w: 30, h: 28, d: 18 },\n  crate: { w: 30, h: 30, d: 22 },\n  bale: { w: 32, h: 30, d: 18 }\n}\n\nexport class Stockpile3D extends RealObjectGroup {\n  private _carriersGroup?: THREE.Group\n  private _padMesh?: THREE.Mesh\n  /** pad 의 외곽선 — strokeStyle 표현 (2D dashed outline 의 3D 대응). */\n  private _padOutline?: THREE.LineSegments\n  /** record.id → 해당 carrier mesh 매핑 — popup anchor / tether 의 대상으로 사용. */\n  private _meshByRecordId: Map<string, THREE.Mesh> = new Map()\n  /** Legend 매핑된 색을 material 로 캐시 — 같은 색 record 들은 material 공유 (drawcall ↓). */\n  private _materialByColor: Map<number, THREE.MeshStandardMaterial> = new Map()\n\n  private _getMaterialForColor(colorHex: number): THREE.MeshStandardMaterial {\n    let m = this._materialByColor.get(colorHex)\n    if (!m) {\n      m = new THREE.MeshStandardMaterial({ color: colorHex, roughness: 0.7 })\n      this._materialByColor.set(colorHex, m)\n    }\n    return m\n  }\n\n  private _disposeMaterialCache(): void {\n    for (const m of this._materialByColor.values()) m.dispose()\n    this._materialByColor.clear()\n  }\n\n  build() {\n    super.build()\n    const state = this.component.state as any\n    const w = state.width ?? 100\n    const h = state.height ?? 100\n\n    // ── floor pad — 영역 표시 (얇은 box) ──────────────────────────────\n    const padGeom = new THREE.BoxGeometry(w, PAD_DEPTH, h)\n    const padColor = this._padColor()\n    const padMat = new THREE.MeshStandardMaterial({\n      color: padColor, roughness: 0.85, transparent: true, opacity: 0.55,\n      emissive: padColor, emissiveIntensity: 0.05\n    })\n    this._padMesh = new THREE.Mesh(padGeom, padMat)\n    this._padMesh.position.y = PAD_DEPTH / 2\n    this._padMesh.receiveShadow = true\n    this.object3d.add(this._padMesh)\n\n    // pad 외곽선 — strokeStyle 3D 표현. 2D 의 dashed outline 과 같은 의도.\n    const outlineColor = this._strokeColor()\n    const outlineMat = new THREE.LineBasicMaterial({ color: outlineColor })\n    this._padOutline = new THREE.LineSegments(new THREE.EdgesGeometry(padGeom), outlineMat)\n    this._padOutline.position.y = PAD_DEPTH / 2\n    this.object3d.add(this._padOutline)\n\n    // ── carriers group — records 기반 자동 적치 ─────────────────────\n    this._carriersGroup = new THREE.Group()\n    this._carriersGroup.position.y = PAD_DEPTH\n    this.object3d.add(this._carriersGroup)\n    this._rebuildCarriers()\n  }\n\n  update() {\n    super.update()\n    this._rebuildCarriers()\n  }\n\n  /**\n   * carrier attach point.\n   *   - slotId 가 record.id 와 매칭되면 그 record 의 mesh 반환 → popup tether 가 정확히\n   *     해당 stock 에 연결.\n   *   - 아니면 pad 반환 (단일 'pile' slot, mover place 의 default anchor).\n   */\n  getAttachFrame(slotId?: string): THREE.Object3D | undefined {\n    if (slotId) {\n      const mesh = this._meshByRecordId.get(slotId)\n      if (mesh) return mesh\n    }\n    return this._padMesh\n  }\n\n  /** state.fillStyle → THREE.Color. 잘못된 값/없으면 default. capacity 점유율에 따른\n   *  색 변경은 강요하지 않음 — 필요하면 사용자가 mapping(eval)으로 fillStyle 을 조정. */\n  private _padColor(): THREE.Color {\n    const raw = (this.component.state as any)?.fillStyle\n    if (typeof raw === 'string' && raw.length > 0) {\n      try { return new THREE.Color(raw) } catch { /* fallthrough */ }\n    }\n    return new THREE.Color(0xc89c5c)\n  }\n\n  /** state.strokeStyle → THREE.Color (pad 외곽선 색). 미설정 시 fillStyle 따라가되\n   *  대비 위해 약간 어둡게 */\n  private _strokeColor(): THREE.Color {\n    const raw = (this.component.state as any)?.strokeStyle\n    if (typeof raw === 'string' && raw.length > 0) {\n      try { return new THREE.Color(raw) } catch { /* fallthrough */ }\n    }\n    return this._padColor().clone().multiplyScalar(0.6)\n  }\n\n  private _applyStrokeColor(): void {\n    if (!this._padOutline) return\n    const m = this._padOutline.material as THREE.LineBasicMaterial\n    m.color.copy(this._strokeColor())\n    m.needsUpdate = true\n  }\n\n  /** state.fillStyle 변경 즉시 반영 — pad material 의 color + emissive 갱신. */\n  private _applyPadColor(): void {\n    if (!this._padMesh) return\n    const m = this._padMesh.material as THREE.MeshStandardMaterial\n    const c = this._padColor()\n    m.color.copy(c)\n    m.emissive.copy(c)\n    m.needsUpdate = true\n  }\n\n  private _rebuildCarriers(): void {\n    const g = this._carriersGroup\n    if (!g) return\n    // 기존 mesh 모두 제거 (geometry/material 은 공유돼 dispose 안 함)\n    while (g.children.length > 0) g.remove(g.children[0])\n\n    const stockpile = this.component as unknown as Stockpile\n    const count = stockpile.records.length\n    if (count === 0) return\n\n    const state = stockpile.state as any\n    const areaW = state.width ?? 100\n    const areaH = state.height ?? 100\n    const pattern = (state.stackPattern as StackPattern) ?? 'row'\n    const preset = (state.carrierPreset as CarrierPreset) ?? 'box'\n\n    // carrier 크기 — 명시값 우선, 없으면 preset default\n    const def = PRESET_DEFAULT_SIZE[preset] ?? PRESET_DEFAULT_SIZE.box\n    const cw = state.carrierWidth ?? def.w\n    const ch = state.carrierHeight ?? def.h\n    const cd = state.carrierDepth ?? def.d\n    const gap = state.carrierGap ?? 10   // 평면(xz) cell 간격 — 0 이면 딱 붙음. carrier 크기 대비 충분히 분리되도록 default 10.\n\n    const geom = this._carrierGeometry(preset, cw, ch, cd)\n    // record 별로 색이 다를 수 있어(Legend 매핑) material 을 record 별로 생성.\n    // 같은 색은 material 캐시로 공유해 dispose 비용 / drawcall 최적화.\n    const presetDefaultColor = PRESET_COLOR[preset] ?? PRESET_COLOR.box\n    this._disposeMaterialCache()\n    const resolveColor = (record: any): number => {\n      const legendColor = (stockpile as any).resolveLegendColor?.(record)\n      if (typeof legendColor === 'string' && legendColor.length > 0) {\n        try { return new THREE.Color(legendColor).getHex() } catch { /* fallthrough */ }\n      }\n      return presetDefaultColor\n    }\n\n    const positions = this._computeStackPositions(pattern, count, areaW, areaH, cw, ch, cd, gap, state.stackHeightLimit)\n    this._meshByRecordId.clear()\n    const records = stockpile.records\n    for (let i = 0; i < positions.length; i++) {\n      const p = positions[i]\n      const record = records[i]\n      const colorHex = resolveColor(record)\n      const mat = this._getMaterialForColor(colorHex)\n      const mesh = new THREE.Mesh(geom, mat)\n      mesh.position.set(p.x, p.y, p.z)\n      mesh.castShadow = true\n      mesh.receiveShadow = true\n      // raycast hit → record 식별을 위해 userData 에 recordId 저장 + Map 갱신.\n      const rid = records[i]?.id\n      if (rid != null) {\n        mesh.userData.recordId = String(rid)\n        this._meshByRecordId.set(String(rid), mesh)\n      }\n      g.add(mesh)\n    }\n  }\n\n  /** record.id 로 해당 carrier mesh 직접 조회 — popup tether anchor 용. */\n  getMeshByRecordId(recordId: string): THREE.Mesh | undefined {\n    return this._meshByRecordId.get(recordId)\n  }\n\n  /**\n   * stackPattern 별 각 carrier 의 local 좌표(영역 중심 기준). y 는 pad 위에 쌓이는\n   * 높이(cd 단위), x/z 는 영역 평면 위 분포.\n   */\n  private _computeStackPositions(\n    pattern: StackPattern,\n    count: number,\n    areaW: number,\n    areaH: number,\n    cw: number,\n    ch: number,\n    cd: number,\n    gap: number,\n    heightLimit?: number\n  ): Array<{ x: number; y: number; z: number }> {\n    const out: Array<{ x: number; y: number; z: number }> = []\n\n    // column — 한 자리에 수직 적층\n    if (pattern === 'column') {\n      const layers = heightLimit ?? count\n      for (let i = 0; i < count; i++) {\n        const layer = Math.min(i, layers - 1)\n        out.push({ x: 0, y: layer * cd + cd / 2, z: 0 })\n      }\n      return out\n    }\n\n    // 격자 cell — 행/열 수. cell stride = carrier + gap (인접 carrier 사이 분리).\n    const stridX = cw + gap\n    const stridZ = ch + gap\n    const cols = Math.max(1, Math.floor((areaW + gap) / stridX))\n    const rows = Math.max(1, Math.floor((areaH + gap) / stridZ))\n    const cellsPerLayer = cols * rows\n\n    // pyramid — 위로 갈수록 행/열 -1 씩 (사다리꼴)\n    if (pattern === 'pyramid') {\n      let remaining = count\n      let layer = 0\n      while (remaining > 0) {\n        const lcols = Math.max(1, cols - layer)\n        const lrows = Math.max(1, rows - layer)\n        const cellsThisLayer = lcols * lrows\n        const take = Math.min(remaining, cellsThisLayer)\n        for (let i = 0; i < take; i++) {\n          const c = i % lcols\n          const r = Math.floor(i / lcols)\n          // 가운데 정렬 — 줄어든 만큼 offset\n          const offsetCol = (cols - lcols) / 2\n          const offsetRow = (rows - lrows) / 2\n          const x = -areaW / 2 + (c + offsetCol + 0.5) * stridX\n          const z = -areaH / 2 + (r + offsetRow + 0.5) * stridZ\n          out.push({ x, y: layer * cd + cd / 2, z })\n        }\n        remaining -= take\n        layer++\n        if (lcols === 1 && lrows === 1) {\n          // 정상에 도달 — 남은 건 column 처럼 위로\n          for (let i = 0; i < remaining; i++) {\n            out.push({ x: 0, y: (layer + i) * cd + cd / 2, z: 0 })\n          }\n          break\n        }\n        if (heightLimit && layer >= heightLimit) break\n      }\n      return out\n    }\n\n    // pile — 자연 더미. row 와 비슷하되 가장자리는 약간 옆으로 흘러내림 효과\n    // (간단 구현 — 단마다 약간 random offset).\n    if (pattern === 'pile') {\n      // pseudo-random (인덱스 기반, deterministic)\n      const rng = (i: number) => ((Math.sin(i * 12.9898) * 43758.5453) % 1 + 1) % 1\n      for (let i = 0; i < count; i++) {\n        const layer = Math.floor(i / cellsPerLayer)\n        const idx = i % cellsPerLayer\n        const c = idx % cols\n        const r = Math.floor(idx / cols)\n        const jitterX = (rng(i * 2) - 0.5) * cw * 0.2\n        const jitterZ = (rng(i * 2 + 1) - 0.5) * ch * 0.2\n        const x = -areaW / 2 + (c + 0.5) * stridX + jitterX\n        const z = -areaH / 2 + (r + 0.5) * stridZ + jitterZ\n        out.push({ x, y: layer * cd + cd / 2, z })\n        if (heightLimit && layer >= heightLimit - 1 && idx === cellsPerLayer - 1) break\n      }\n      return out\n    }\n\n    // row (default) / staggered — 격자 적층\n    for (let i = 0; i < count; i++) {\n      const layer = Math.floor(i / cellsPerLayer)\n      if (heightLimit && layer >= heightLimit) break\n      const idx = i % cellsPerLayer\n      const c = idx % cols\n      const r = Math.floor(idx / cols)\n      let x = -areaW / 2 + (c + 0.5) * stridX\n      const z = -areaH / 2 + (r + 0.5) * stridZ\n      // staggered — 홀수 layer 는 1/2 cell offset (벽돌식)\n      if (pattern === 'staggered' && layer % 2 === 1) {\n        x += stridX / 2\n      }\n      out.push({ x, y: layer * cd + cd / 2, z })\n    }\n    return out\n  }\n\n  /** carrierPreset 별 geometry. drum 은 cylinder, 나머지는 box. */\n  private _carrierGeometry(preset: CarrierPreset, w: number, h: number, d: number): THREE.BufferGeometry {\n    if (preset === 'drum') {\n      const radius = Math.min(w, h) / 2\n      return new THREE.CylinderGeometry(radius, radius, d, 16)\n    }\n    // sack/bale — 약간 작게 (자연스러운 형태)\n    if (preset === 'sack' || preset === 'bale') {\n      return new THREE.BoxGeometry(w * 0.92, d * 0.92, h * 0.92)\n    }\n    return new THREE.BoxGeometry(w, d, h)\n  }\n\n  /**\n   * state.alpha 변경 시 pad + carriers 의 material opacity 즉시 반영.\n   * pad 는 원래 0.55 base opacity 위에 alpha 곱 (영역 표시가 너무 진해지지 않도록).\n   * carriers 는 alpha 그대로 (단순한 곱은 fully opaque 이 1, 반투명이 0).\n   */\n  updateAlpha(): void {\n    const state = this.component.state as any\n    const alpha = typeof state.alpha === 'number' ? state.alpha : 1\n    if (this._padMesh) {\n      const m = this._padMesh.material as THREE.MeshStandardMaterial\n      m.opacity = 0.55 * alpha\n      m.transparent = m.opacity < 1\n      m.needsUpdate = true\n    }\n    if (this._carriersGroup) {\n      for (const child of this._carriersGroup.children) {\n        const mesh = child as THREE.Mesh\n        const m = mesh.material as THREE.MeshStandardMaterial\n        if (!m) continue\n        m.opacity = alpha\n        m.transparent = alpha < 1\n        m.needsUpdate = true\n      }\n    }\n  }\n\n  updateDimension(): void {\n    // width/height 변경 시 pad geometry + outline + carriers 재계산\n    if (this._padMesh) {\n      const state = this.component.state as any\n      const w = state.width ?? 100\n      const h = state.height ?? 100\n      this._padMesh.geometry.dispose()\n      this._padMesh.geometry = new THREE.BoxGeometry(w, PAD_DEPTH, h)\n      if (this._padOutline) {\n        this._padOutline.geometry.dispose()\n        this._padOutline.geometry = new THREE.EdgesGeometry(this._padMesh.geometry)\n      }\n    }\n    this._rebuildCarriers()\n  }\n\n  /**\n   * state 변경 시 즉시 3D 갱신 — property panel 의 수정이 바로 반영되도록.\n   *   - width/height → pad geometry 재생성 + carriers 재계산 (updateDimension)\n   *   - 적치/외형 관련 키 → carriers 만 재계산 (_rebuildCarriers)\n   */\n  onchange(after: Record<string, unknown>, before: Record<string, unknown>): void {\n    if ('width' in after || 'height' in after) {\n      this.updateDimension()\n      return\n    }\n    if ('alpha' in after) {\n      this.updateAlpha()\n      return\n    }\n    if ('fillStyle' in after) {\n      this._applyPadColor()\n      // fillStyle 변경 시 strokeStyle 미설정이면 outline default 도 같이 갱신\n      if ((this.component.state as any).strokeStyle == null) this._applyStrokeColor()\n      return\n    }\n    if ('strokeStyle' in after) {\n      this._applyStrokeColor()\n      return\n    }\n    const rebuildKeys = [\n      'data',\n      'stackPattern', 'carrierPreset',\n      'carrierWidth', 'carrierHeight', 'carrierDepth', 'carrierGap',\n      'capacity', 'stackHeightLimit', 'pickPolicy'\n    ]\n    if (rebuildKeys.some(k => k in after)) {\n      this._rebuildCarriers()\n      return\n    }\n    super.onchange?.(after, before)\n  }\n}\n"]}

package/dist/stockpile-grid-3d.d.ts

@@ -0,0 +1,30 @@
+import * as THREE from 'three';
+import { RealObjectGroup } from '@hatiolab/things-scene';
+export declare class StockpileGrid3D extends RealObjectGroup {
+    /** cellSlotId → pad mesh (popup tether anchor 용). */
+    private _padByCellId;
+    /** cellSlotId → carriers group. */
+    private _carriersByCellId;
+    /** material 캐시 (color → material) — 같은 색 carrier 공유. */
+    private _materialByColor;
+    /** grid 전체를 감싸는 outer group (보드 보정 등). */
+    private _gridGroup?;
+    build(): void;
+    update(): void;
+    /** carrier attach anchor — slotId 가 cellId 면 그 cell pad 반환, 아니면 grid group. */
+    getAttachFrame(slotId?: string): THREE.Object3D | undefined;
+    /** slotTargetAt(cellId).attachObject3d = cell pad — Stockpile.getSlotAttachObject3d 가 호출. */
+    getCellPadMesh(slotId: string): THREE.Mesh | undefined;
+    private _disposeAll;
+    private _disposeGroupChildren;
+    private _rebuildAll;
+    private _buildGrid;
+    /** cell 의 records 를 stackPattern / carrierPreset 으로 배치. */
+    private _populateCellCarriers;
+    private _computeStackPositions;
+    private _carrierGeometry;
+    private _getMaterial;
+    onchange(after: Record<string, unknown>, before: Record<string, unknown>): void;
+    updateDimension(): void;
+    updateAlpha(): void;
+}