@operato/scene-storage 10.0.0-beta.57 → 10.0.0-beta.59

package/CHANGELOG.md

@@ -3,6 +3,37 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [10.0.0-beta.59](https://github.com/things-scene/operato-scene/compare/v10.0.0-beta.58...v10.0.0-beta.59) (2026-06-17)
+
+
+### :rocket: New Features
+
+* **routing:** Phase B1 — RoutingTarget.routingWeight capability + sink 구현 + validator warning ([d25288d](https://github.com/things-scene/operato-scene/commit/d25288d516509658f446d5a24746aa4b72faa475))
+
+
+### :bug: Bug Fix
+
+* **routing:** 라이브 검증 발견 결함 2건 fix + E2E 단위 테스트 추가 ([88e3b59](https://github.com/things-scene/operato-scene/commit/88e3b599cb1d45f3dd804b3e33ab0dddf7c82392))
+
+
+
+## [10.0.0-beta.58](https://github.com/things-scene/operato-scene/compare/v10.0.0-beta.57...v10.0.0-beta.58) (2026-06-17)
+
+
+### :rocket: New Features
+
+* **scene-base/storage:** SingleSlotHolder mixin 표준화 + records-only holder 일괄 Holdable 적용 ([2624953](https://github.com/things-scene/operato-scene/commit/2624953d6803ec43901118753b6fde8342e11aae))
+* **storage:** Spot 의 Holdable 시범 채택 — _holdings 자식 시스템 (시범 첫 사례) ([d51cfff](https://github.com/things-scene/operato-scene/commit/d51cfff47d1eec8f1ddf3751c9f4e6aac8775dee))
+* **transport/storage:** Mover 일괄 Holdable 적용 + Crane engage 정합 (시범 5) ([2976425](https://github.com/things-scene/operato-scene/commit/2976425ddb066f1ee8fa5d35df55d9967f6717f2))
+
+
+### :house: Code Refactoring
+
+* **storage:** Spot receiveAt → handoverIn 위임 (3D handover inline 제거) ([6765dae](https://github.com/things-scene/operato-scene/commit/6765dae1a955943fe57f5d418a846df62bf74cf0))
+* **storage:** Stockpile transient carrier → _holdings (Holdable 시범 2) ([b8cd38a](https://github.com/things-scene/operato-scene/commit/b8cd38a3fd84b204ef664da1ec735cac2fd571c4))
+
+
+
 ## [10.0.0-beta.57](https://github.com/things-scene/operato-scene/compare/v10.0.0-beta.56...v10.0.0-beta.57) (2026-06-15)
 
 

package/dist/crane.js

@@ -2,7 +2,7 @@ import { __decorate } from "tslib";
 /*
  * Copyright © HatioLab Inc. All rights reserved.
  */
-import { ContainerAbstract, ContainerCapacity, Transfer, getWorldPose, sceneComponent } from '@hatiolab/things-scene';
+import { ContainerAbstract, ContainerCapacity, Holdable, Transfer, getWorldPose, sceneComponent } from '@hatiolab/things-scene';
 import { CarrierHolder, Legendable, Mover, Placeable, isSlottedHolder, findDispatcher, resolveTransferTarget } from '@operato/scene-base';
 import * as THREE from 'three';
 import { Crane3D } from './crane-3d.js';
@@ -132,7 +132,7 @@ const NATURE = {
  * (or `crane.pickAndPlace(carrier, target)`). Mover handles navigation +
  * engage + reparent. During transit the carrier IS a child of the crane.
  */
-let Crane = class Crane extends Mover(CarrierHolder(ContainerCapacity(Legendable(Placeable(ContainerAbstract))))) {
+let Crane = class Crane extends Mover(CarrierHolder(ContainerCapacity(Holdable(Legendable(Placeable(ContainerAbstract)))))) {
     static legends = {
         bodyColor: { from: 'status', legend: BODY_LEGEND },
         lampEmissive: { from: 'status', legend: LAMP_EMISSIVE_LEGEND }
@@ -335,7 +335,8 @@ let Crane = class Crane extends Mover(CarrierHolder(ContainerCapacity(Legendable
         if (targetBottomWorldY !== null) {
             // Phase Z PR-4: 임의 slot 의 carrier 검사 (multi-fork 대비). 단일 'forks'
             // 가정 제거 — c._transferSlotId 가 set 됐으면 어떤 slot 이든 holding.
-            const isHoldingCarrier = this.components?.some?.((c) => c?._transferSlotId != null) ?? false;
+            // Holdable 자손이면 _holdings, 아니면 _components.
+            const isHoldingCarrier = (this._holdings ?? this.components)?.some?.((c) => c?._transferSlotId != null) ?? false;
             const liftH = numOr(this.state.forkLift, 30);
             const approachWorldY = targetBottomWorldY + (isHoldingCarrier ? liftH : 0);
             const ro = this._realObject;
@@ -430,9 +431,13 @@ let Crane = class Crane extends Mover(CarrierHolder(ContainerCapacity(Legendable
         }
         if (kind === 'pick') {
             this.setState({ status: 'loading' });
+            // 1. fork extend — cell 위 carrier 위치로 fork 진입.
             await this._tween({ forkExtension: extTarget }, D_EXT);
-            // Mid-engage reparent — fork 가 cell 안 도달. carrier 를 fork 위로 *즉시
-            // snap* (animated:false). Transfer 객체 통과 → monitor panel 추적.
+            // 2. fork lift — carrier 떠올림. 이 시점에 carrier 가 *_물리적으로 fork 위에
+            //    얹힘_* — handover 의 자연 타이밍.
+            await this._tween({ forkLiftRT: liftH }, D_LIFT);
+            // 3. Mid-engage reparent — carrier 가 fork 위로 *즉시 snap* (animated:false).
+            //    Transfer 객체 통과 → monitor panel 추적. lift 직후 = 떠올린 시점.
             const source = target.parent;
             if (source) {
                 try {
@@ -447,7 +452,7 @@ let Crane = class Crane extends Mover(CarrierHolder(ContainerCapacity(Legendable
                     // Transfer 실패 — carrier 그대로. 후속 Mover.pick receive 가 처리.
                 }
             }
-            await this._tween({ forkLiftRT: liftH }, D_LIFT);
+            // 4. fork retract — carrier 위에 얹힌 채로 빠짐.
             await this._tween({ forkExtension: 0 }, D_EXT);
         }
         else {
@@ -459,7 +464,8 @@ let Crane = class Crane extends Mover(CarrierHolder(ContainerCapacity(Legendable
             await this._tween({ forkLiftRT: 0 }, D_LIFT);
             // 3. dispatch — carrier world 위치 = cell 내 attach 위치, jump 없음. Transfer 추적.
             // Phase Z PR-4: 임의 slot 의 carrier 검사 (multi-fork 대비).
-            const comps = this.components;
+            // Holdable 자손이면 _holdings, 아니면 _components.
+            const comps = (this._holdings ?? this.components);
             const carrier = comps?.find?.((c) => c?._transferSlotId != null)
                 ?? comps?.[0];
             if (carrier) {