@hatiolab/things-scene 10.0.0-beta.14 → 10.0.0-beta.140

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (482) hide show
  1. package/CHANGELOG.md +65 -0
  2. package/README.md +56 -53
  3. package/dist-types/animation/animate.d.ts.map +1 -1
  4. package/dist-types/animation/animations/animation.d.ts +5 -3
  5. package/dist-types/animation/animations/animation.d.ts.map +1 -1
  6. package/dist-types/animation/animations/heartbeat.d.ts +0 -7
  7. package/dist-types/animation/animations/heartbeat.d.ts.map +1 -1
  8. package/dist-types/animation/animations/waypoint.d.ts +45 -4
  9. package/dist-types/animation/animations/waypoint.d.ts.map +1 -1
  10. package/dist-types/animation/interfaces.d.ts +1 -1
  11. package/dist-types/animation/interfaces.d.ts.map +1 -1
  12. package/dist-types/clock/frame-clock.d.ts +119 -0
  13. package/dist-types/clock/frame-clock.d.ts.map +1 -0
  14. package/dist-types/clock/index.d.ts +3 -0
  15. package/dist-types/clock/index.d.ts.map +1 -0
  16. package/dist-types/command/command-migrate.d.ts.map +1 -1
  17. package/dist-types/command/snapshot-commander.d.ts.map +1 -1
  18. package/dist-types/components/audio.d.ts +19 -12
  19. package/dist-types/components/audio.d.ts.map +1 -1
  20. package/dist-types/components/component-data.d.ts +24 -0
  21. package/dist-types/components/component-data.d.ts.map +1 -1
  22. package/dist-types/components/component-drawing.d.ts.map +1 -1
  23. package/dist-types/components/component-geometry.d.ts.map +1 -1
  24. package/dist-types/components/component-hierarchy.d.ts +1 -1
  25. package/dist-types/components/component-hierarchy.d.ts.map +1 -1
  26. package/dist-types/components/component.d.ts +123 -17
  27. package/dist-types/components/component.d.ts.map +1 -1
  28. package/dist-types/components/container-abstract.d.ts +74 -29
  29. package/dist-types/components/container-abstract.d.ts.map +1 -1
  30. package/dist-types/components/container.d.ts +19 -11
  31. package/dist-types/components/container.d.ts.map +1 -1
  32. package/dist-types/components/data/data.d.ts.map +1 -1
  33. package/dist-types/components/data/evaluator.d.ts +27 -0
  34. package/dist-types/components/data/evaluator.d.ts.map +1 -1
  35. package/dist-types/components/donut.d.ts.map +1 -1
  36. package/dist-types/components/drawer/fill.d.ts.map +1 -1
  37. package/dist-types/components/drawer/stroke.d.ts.map +1 -1
  38. package/dist-types/components/ellipse.d.ts +19 -12
  39. package/dist-types/components/ellipse.d.ts.map +1 -1
  40. package/dist-types/components/generic-placeholders.d.ts +294 -0
  41. package/dist-types/components/generic-placeholders.d.ts.map +1 -0
  42. package/dist-types/components/geometry/snap-guide.d.ts +45 -0
  43. package/dist-types/components/geometry/snap-guide.d.ts.map +1 -0
  44. package/dist-types/components/geometry/transcoord.d.ts.map +1 -1
  45. package/dist-types/components/global-ref.d.ts.map +1 -1
  46. package/dist-types/components/group.d.ts +2 -0
  47. package/dist-types/components/group.d.ts.map +1 -1
  48. package/dist-types/components/html/reposition.d.ts.map +1 -1
  49. package/dist-types/components/html/shadow.d.ts +33 -1
  50. package/dist-types/components/html/shadow.d.ts.map +1 -1
  51. package/dist-types/components/html-overlay-container.d.ts +19 -11
  52. package/dist-types/components/html-overlay-container.d.ts.map +1 -1
  53. package/dist-types/components/html-overlay-element.d.ts +38 -23
  54. package/dist-types/components/html-overlay-element.d.ts.map +1 -1
  55. package/dist-types/components/image-view.d.ts +19 -12
  56. package/dist-types/components/image-view.d.ts.map +1 -1
  57. package/dist-types/components/index.d.ts +7 -0
  58. package/dist-types/components/index.d.ts.map +1 -1
  59. package/dist-types/components/info-window.d.ts +19 -12
  60. package/dist-types/components/info-window.d.ts.map +1 -1
  61. package/dist-types/components/line.d.ts +2 -1
  62. package/dist-types/components/line.d.ts.map +1 -1
  63. package/dist-types/components/local-ref.d.ts +19 -12
  64. package/dist-types/components/local-ref.d.ts.map +1 -1
  65. package/dist-types/components/mixins/connectable.d.ts +19 -12
  66. package/dist-types/components/mixins/connectable.d.ts.map +1 -1
  67. package/dist-types/components/mixins/data-source.d.ts +19 -12
  68. package/dist-types/components/mixins/data-source.d.ts.map +1 -1
  69. package/dist-types/components/mixins/gltf-component.d.ts +282 -0
  70. package/dist-types/components/mixins/gltf-component.d.ts.map +1 -0
  71. package/dist-types/components/mixins/holdable.d.ts +12 -0
  72. package/dist-types/components/mixins/holdable.d.ts.map +1 -0
  73. package/dist-types/components/mixins/html-element.d.ts +28 -11
  74. package/dist-types/components/mixins/html-element.d.ts.map +1 -1
  75. package/dist-types/components/mixins/move-handle.d.ts +28 -16
  76. package/dist-types/components/mixins/move-handle.d.ts.map +1 -1
  77. package/dist-types/components/mixins/rect-path.d.ts +19 -12
  78. package/dist-types/components/mixins/rect-path.d.ts.map +1 -1
  79. package/dist-types/components/mixins/three-d-only.d.ts +256 -0
  80. package/dist-types/components/mixins/three-d-only.d.ts.map +1 -0
  81. package/dist-types/components/mixins/value-holder.d.ts +19 -12
  82. package/dist-types/components/mixins/value-holder.d.ts.map +1 -1
  83. package/dist-types/components/modeling-faint.d.ts +14 -0
  84. package/dist-types/components/modeling-faint.d.ts.map +1 -0
  85. package/dist-types/components/mutater/path.d.ts.map +1 -1
  86. package/dist-types/components/node.d.ts +19 -12
  87. package/dist-types/components/node.d.ts.map +1 -1
  88. package/dist-types/components/outline/path-outline.d.ts.map +1 -1
  89. package/dist-types/components/polygon-container.d.ts +61 -0
  90. package/dist-types/components/polygon-container.d.ts.map +1 -0
  91. package/dist-types/components/polygon.d.ts +2 -0
  92. package/dist-types/components/polygon.d.ts.map +1 -1
  93. package/dist-types/components/polyline.d.ts +6 -0
  94. package/dist-types/components/polyline.d.ts.map +1 -1
  95. package/dist-types/components/popup-container.d.ts +25 -0
  96. package/dist-types/components/popup-container.d.ts.map +1 -0
  97. package/dist-types/components/popup.d.ts +49 -12
  98. package/dist-types/components/popup.d.ts.map +1 -1
  99. package/dist-types/components/position/popup-position.d.ts +11 -0
  100. package/dist-types/components/position/popup-position.d.ts.map +1 -1
  101. package/dist-types/components/rect.d.ts +38 -24
  102. package/dist-types/components/rect.d.ts.map +1 -1
  103. package/dist-types/components/retention/retention-manager.d.ts +9 -1
  104. package/dist-types/components/retention/retention-manager.d.ts.map +1 -1
  105. package/dist-types/components/root-container.d.ts +18 -4
  106. package/dist-types/components/root-container.d.ts.map +1 -1
  107. package/dist-types/components/ruler.d.ts +19 -12
  108. package/dist-types/components/ruler.d.ts.map +1 -1
  109. package/dist-types/components/service-component.d.ts +271 -0
  110. package/dist-types/components/service-component.d.ts.map +1 -0
  111. package/dist-types/components/shape.d.ts.map +1 -1
  112. package/dist-types/components/star.d.ts.map +1 -1
  113. package/dist-types/components/text.d.ts +19 -12
  114. package/dist-types/components/text.d.ts.map +1 -1
  115. package/dist-types/core/dom-to-image.d.ts.map +1 -1
  116. package/dist-types/core/logger.d.ts.map +1 -1
  117. package/dist-types/core/memoize.d.ts.map +1 -1
  118. package/dist-types/decorator/decorator-registry.d.ts +14 -1
  119. package/dist-types/decorator/decorator-registry.d.ts.map +1 -1
  120. package/dist-types/decorator/decorators/animated-icon-decorator.d.ts.map +1 -1
  121. package/dist-types/decorator/decorators/border-highlighting-decorator.d.ts +0 -4
  122. package/dist-types/decorator/decorators/border-highlighting-decorator.d.ts.map +1 -1
  123. package/dist-types/decorator/decorators/bouncing-arrow-decorator.d.ts +0 -3
  124. package/dist-types/decorator/decorators/bouncing-arrow-decorator.d.ts.map +1 -1
  125. package/dist-types/decorator/decorators/data-spread-decorator.d.ts +16 -0
  126. package/dist-types/decorator/decorators/data-spread-decorator.d.ts.map +1 -1
  127. package/dist-types/diagnostics/contract-inspector.d.ts +110 -0
  128. package/dist-types/diagnostics/contract-inspector.d.ts.map +1 -0
  129. package/dist-types/diagnostics/data-lag-tracker.d.ts +50 -0
  130. package/dist-types/diagnostics/data-lag-tracker.d.ts.map +1 -0
  131. package/dist-types/diagnostics/inspector.d.ts +192 -5
  132. package/dist-types/diagnostics/inspector.d.ts.map +1 -1
  133. package/dist-types/diagnostics/load-tracker.d.ts +82 -0
  134. package/dist-types/diagnostics/load-tracker.d.ts.map +1 -0
  135. package/dist-types/diagnostics/loading-overlay.d.ts +98 -0
  136. package/dist-types/diagnostics/loading-overlay.d.ts.map +1 -0
  137. package/dist-types/diagnostics/metrics.d.ts +10 -0
  138. package/dist-types/diagnostics/metrics.d.ts.map +1 -1
  139. package/dist-types/effect/shadow.d.ts +3 -1
  140. package/dist-types/effect/shadow.d.ts.map +1 -1
  141. package/dist-types/event-map/index.d.ts +1 -0
  142. package/dist-types/event-map/index.d.ts.map +1 -1
  143. package/dist-types/event-map/transition-handler.d.ts +2 -0
  144. package/dist-types/event-map/transition-handler.d.ts.map +1 -0
  145. package/dist-types/flow/auto-route.d.ts +36 -0
  146. package/dist-types/flow/auto-route.d.ts.map +1 -0
  147. package/dist-types/flow/capability-inference.d.ts +19 -0
  148. package/dist-types/flow/capability-inference.d.ts.map +1 -0
  149. package/dist-types/flow/face-anchors.d.ts +26 -0
  150. package/dist-types/flow/face-anchors.d.ts.map +1 -0
  151. package/dist-types/flow/flow-engine.d.ts +122 -0
  152. package/dist-types/flow/flow-engine.d.ts.map +1 -0
  153. package/dist-types/flow/flow-graph-coordinator.d.ts +80 -0
  154. package/dist-types/flow/flow-graph-coordinator.d.ts.map +1 -0
  155. package/dist-types/flow/flow-graph-validator.d.ts +33 -0
  156. package/dist-types/flow/flow-graph-validator.d.ts.map +1 -0
  157. package/dist-types/flow/flow-graph.d.ts +76 -0
  158. package/dist-types/flow/flow-graph.d.ts.map +1 -0
  159. package/dist-types/flow/flow-introspection.d.ts +36 -0
  160. package/dist-types/flow/flow-introspection.d.ts.map +1 -0
  161. package/dist-types/flow/flow-node.d.ts +69 -0
  162. package/dist-types/flow/flow-node.d.ts.map +1 -0
  163. package/dist-types/flow/flow-orientation-coordinator.d.ts +13 -0
  164. package/dist-types/flow/flow-orientation-coordinator.d.ts.map +1 -0
  165. package/dist-types/flow/flow-orientation.d.ts +42 -0
  166. package/dist-types/flow/flow-orientation.d.ts.map +1 -0
  167. package/dist-types/flow/flow-trace.d.ts +5 -0
  168. package/dist-types/flow/flow-trace.d.ts.map +1 -0
  169. package/dist-types/flow/index.d.ts +16 -0
  170. package/dist-types/flow/index.d.ts.map +1 -0
  171. package/dist-types/flow/segment-topology.d.ts +225 -0
  172. package/dist-types/flow/segment-topology.d.ts.map +1 -0
  173. package/dist-types/interfaces/event-handler.d.ts +40 -0
  174. package/dist-types/interfaces/event-handler.d.ts.map +1 -0
  175. package/dist-types/interfaces/index.d.ts +2 -0
  176. package/dist-types/interfaces/index.d.ts.map +1 -1
  177. package/dist-types/interfaces/layout.d.ts +35 -1
  178. package/dist-types/interfaces/layout.d.ts.map +1 -1
  179. package/dist-types/interfaces/providers.d.ts +27 -3
  180. package/dist-types/interfaces/providers.d.ts.map +1 -1
  181. package/dist-types/interfaces/real-object.d.ts +8 -1
  182. package/dist-types/interfaces/real-object.d.ts.map +1 -1
  183. package/dist-types/interfaces/rendering.d.ts +86 -14
  184. package/dist-types/interfaces/rendering.d.ts.map +1 -1
  185. package/dist-types/interfaces/types.d.ts +20 -1
  186. package/dist-types/interfaces/types.d.ts.map +1 -1
  187. package/dist-types/items/arrangement/centering-queue-strategy.d.ts +10 -0
  188. package/dist-types/items/arrangement/centering-queue-strategy.d.ts.map +1 -0
  189. package/dist-types/items/arrangement/index.d.ts +2 -0
  190. package/dist-types/items/arrangement/index.d.ts.map +1 -0
  191. package/dist-types/items/capacity-mixin.d.ts +303 -0
  192. package/dist-types/items/capacity-mixin.d.ts.map +1 -0
  193. package/dist-types/items/capacity.d.ts +53 -0
  194. package/dist-types/items/capacity.d.ts.map +1 -0
  195. package/dist-types/items/index.d.ts +7 -0
  196. package/dist-types/items/index.d.ts.map +1 -0
  197. package/dist-types/items/items-data-binding.d.ts +103 -0
  198. package/dist-types/items/items-data-binding.d.ts.map +1 -0
  199. package/dist-types/items/slot-record.d.ts +23 -0
  200. package/dist-types/items/slot-record.d.ts.map +1 -0
  201. package/dist-types/items/stacking/index.d.ts +3 -0
  202. package/dist-types/items/stacking/index.d.ts.map +1 -0
  203. package/dist-types/items/stacking/stack-layout.d.ts +33 -0
  204. package/dist-types/items/stacking/stack-layout.d.ts.map +1 -0
  205. package/dist-types/items/stacking/stacking-strategy.d.ts +114 -0
  206. package/dist-types/items/stacking/stacking-strategy.d.ts.map +1 -0
  207. package/dist-types/layer/action/popup.d.ts +13 -0
  208. package/dist-types/layer/action/popup.d.ts.map +1 -1
  209. package/dist-types/layer/add-layer.d.ts +8 -0
  210. package/dist-types/layer/add-layer.d.ts.map +1 -1
  211. package/dist-types/layer/dual-canvas-layer.d.ts.map +1 -1
  212. package/dist-types/layer/index.d.ts +1 -0
  213. package/dist-types/layer/index.d.ts.map +1 -1
  214. package/dist-types/layer/layer.d.ts +2 -0
  215. package/dist-types/layer/layer.d.ts.map +1 -1
  216. package/dist-types/layer/model-layer.d.ts +79 -7
  217. package/dist-types/layer/model-layer.d.ts.map +1 -1
  218. package/dist-types/layer/modeler/index.d.ts +1 -0
  219. package/dist-types/layer/modeler/index.d.ts.map +1 -1
  220. package/dist-types/layer/modeler/move-handle-icon.d.ts +2 -0
  221. package/dist-types/layer/modeler/move-handle-icon.d.ts.map +1 -0
  222. package/dist-types/layer/modeler/move-handle-modeler.d.ts +18 -0
  223. package/dist-types/layer/modeler/move-handle-modeler.d.ts.map +1 -0
  224. package/dist-types/layer/modeler/path-handler.d.ts.map +1 -1
  225. package/dist-types/layer/modeler/rotator.d.ts.map +1 -1
  226. package/dist-types/layer/modeling-layer.d.ts +19 -0
  227. package/dist-types/layer/modeling-layer.d.ts.map +1 -1
  228. package/dist-types/layer/selection/selected-finder.d.ts +1 -1
  229. package/dist-types/layer/selection/selected-finder.d.ts.map +1 -1
  230. package/dist-types/layer/selection-layer.d.ts +7 -0
  231. package/dist-types/layer/selection-layer.d.ts.map +1 -1
  232. package/dist-types/layer/snap-guide-layer.d.ts +23 -0
  233. package/dist-types/layer/snap-guide-layer.d.ts.map +1 -0
  234. package/dist-types/layout/absolute.d.ts +2 -2
  235. package/dist-types/layout/card.d.ts +2 -2
  236. package/dist-types/layout/linear-horizontal.d.ts +2 -2
  237. package/dist-types/layout/linear-vertical.d.ts +2 -2
  238. package/dist-types/layout/table.d.ts +3 -3
  239. package/dist-types/license/license.d.ts.map +1 -1
  240. package/dist-types/math/component-pose.d.ts +51 -0
  241. package/dist-types/math/component-pose.d.ts.map +1 -0
  242. package/dist-types/math/index.d.ts +3 -0
  243. package/dist-types/math/index.d.ts.map +1 -0
  244. package/dist-types/math/pose6dof.d.ts +93 -0
  245. package/dist-types/math/pose6dof.d.ts.map +1 -0
  246. package/dist-types/navigation/index.d.ts +7 -0
  247. package/dist-types/navigation/index.d.ts.map +1 -0
  248. package/dist-types/navigation/nav-graph.d.ts +55 -0
  249. package/dist-types/navigation/nav-graph.d.ts.map +1 -0
  250. package/dist-types/navigation/path-planner.d.ts +29 -0
  251. package/dist-types/navigation/path-planner.d.ts.map +1 -0
  252. package/dist-types/navigation/reservation-table.d.ts +103 -0
  253. package/dist-types/navigation/reservation-table.d.ts.map +1 -0
  254. package/dist-types/navigation/types.d.ts +145 -0
  255. package/dist-types/navigation/types.d.ts.map +1 -0
  256. package/dist-types/placement/index.d.ts +3 -0
  257. package/dist-types/placement/index.d.ts.map +1 -0
  258. package/dist-types/placement/placement.d.ts +53 -0
  259. package/dist-types/placement/placement.d.ts.map +1 -0
  260. package/dist-types/search/index.d.ts +3 -0
  261. package/dist-types/search/index.d.ts.map +1 -0
  262. package/dist-types/search/scene-search-engine.d.ts +64 -0
  263. package/dist-types/search/scene-search-engine.d.ts.map +1 -0
  264. package/dist-types/search/search-overlay.d.ts +94 -0
  265. package/dist-types/search/search-overlay.d.ts.map +1 -0
  266. package/dist-types/things-scene/api/add-start.d.ts +25 -0
  267. package/dist-types/things-scene/api/add-start.d.ts.map +1 -1
  268. package/dist-types/things-scene/api/align.d.ts.map +1 -1
  269. package/dist-types/things-scene/api/clipboard.d.ts +1 -1
  270. package/dist-types/things-scene/api/clipboard.d.ts.map +1 -1
  271. package/dist-types/things-scene/api/distribute.d.ts.map +1 -1
  272. package/dist-types/things-scene/api/ids.d.ts +4 -1
  273. package/dist-types/things-scene/api/ids.d.ts.map +1 -1
  274. package/dist-types/things-scene/api/index.d.ts +1 -1
  275. package/dist-types/things-scene/api/index.d.ts.map +1 -1
  276. package/dist-types/things-scene/api/listener.d.ts +1 -1
  277. package/dist-types/things-scene/api/listener.d.ts.map +1 -1
  278. package/dist-types/things-scene/api/place.d.ts.map +1 -1
  279. package/dist-types/things-scene/api/to-data-url.d.ts +1 -1
  280. package/dist-types/things-scene/api/to-data-url.d.ts.map +1 -1
  281. package/dist-types/things-scene/api/zorder.d.ts +1 -1
  282. package/dist-types/things-scene/api/zorder.d.ts.map +1 -1
  283. package/dist-types/things-scene/application-context.d.ts +62 -0
  284. package/dist-types/things-scene/application-context.d.ts.map +1 -1
  285. package/dist-types/things-scene/create.d.ts +67 -3
  286. package/dist-types/things-scene/create.d.ts.map +1 -1
  287. package/dist-types/things-scene/index.d.ts +30 -0
  288. package/dist-types/things-scene/index.d.ts.map +1 -1
  289. package/dist-types/things-scene/scene.d.ts +196 -21
  290. package/dist-types/things-scene/scene.d.ts.map +1 -1
  291. package/dist-types/threed/arrow-3d.d.ts +13 -4
  292. package/dist-types/threed/arrow-3d.d.ts.map +1 -1
  293. package/dist-types/threed/common.d.ts +6 -1
  294. package/dist-types/threed/common.d.ts.map +1 -1
  295. package/dist-types/threed/environments/base-environment.d.ts +17 -0
  296. package/dist-types/threed/environments/base-environment.d.ts.map +1 -0
  297. package/dist-types/threed/environments/cloudy-environment.d.ts +10 -0
  298. package/dist-types/threed/environments/cloudy-environment.d.ts.map +1 -0
  299. package/dist-types/threed/environments/factory-environment.d.ts +3 -3
  300. package/dist-types/threed/environments/factory-environment.d.ts.map +1 -1
  301. package/dist-types/threed/environments/home-environment.d.ts +3 -3
  302. package/dist-types/threed/environments/home-environment.d.ts.map +1 -1
  303. package/dist-types/threed/environments/office-environment.d.ts +3 -3
  304. package/dist-types/threed/environments/office-environment.d.ts.map +1 -1
  305. package/dist-types/threed/environments/rainy-environment.d.ts +10 -0
  306. package/dist-types/threed/environments/rainy-environment.d.ts.map +1 -0
  307. package/dist-types/threed/environments/studio-environment.d.ts +2 -3
  308. package/dist-types/threed/environments/studio-environment.d.ts.map +1 -1
  309. package/dist-types/threed/environments/sunny-environment.d.ts +10 -0
  310. package/dist-types/threed/environments/sunny-environment.d.ts.map +1 -0
  311. package/dist-types/threed/environments/warehouse-environment.d.ts +3 -3
  312. package/dist-types/threed/environments/warehouse-environment.d.ts.map +1 -1
  313. package/dist-types/threed/factories/backdrop.d.ts +542 -0
  314. package/dist-types/threed/factories/backdrop.d.ts.map +1 -0
  315. package/dist-types/threed/factories/banner.d.ts +25 -13
  316. package/dist-types/threed/factories/banner.d.ts.map +1 -1
  317. package/dist-types/threed/factories/camera.d.ts +21 -12
  318. package/dist-types/threed/factories/camera.d.ts.map +1 -1
  319. package/dist-types/threed/factories/cube.d.ts +20 -12
  320. package/dist-types/threed/factories/cube.d.ts.map +1 -1
  321. package/dist-types/threed/factories/cylinder.d.ts +1 -0
  322. package/dist-types/threed/factories/cylinder.d.ts.map +1 -1
  323. package/dist-types/threed/factories/decal.d.ts +517 -0
  324. package/dist-types/threed/factories/decal.d.ts.map +1 -0
  325. package/dist-types/threed/factories/floor-plate.d.ts +12 -0
  326. package/dist-types/threed/factories/floor-plate.d.ts.map +1 -0
  327. package/dist-types/threed/factories/gltf-object.d.ts +279 -47
  328. package/dist-types/threed/factories/gltf-object.d.ts.map +1 -1
  329. package/dist-types/threed/factories/group.d.ts +2 -0
  330. package/dist-types/threed/factories/group.d.ts.map +1 -0
  331. package/dist-types/threed/factories/light.d.ts +1 -0
  332. package/dist-types/threed/factories/light.d.ts.map +1 -1
  333. package/dist-types/threed/factories/line.d.ts +10 -0
  334. package/dist-types/threed/factories/line.d.ts.map +1 -0
  335. package/dist-types/threed/factories/ortholine.d.ts +10 -0
  336. package/dist-types/threed/factories/ortholine.d.ts.map +1 -0
  337. package/dist-types/threed/factories/polygon.d.ts +19 -0
  338. package/dist-types/threed/factories/polygon.d.ts.map +1 -1
  339. package/dist-types/threed/factories/polyline.d.ts +10 -0
  340. package/dist-types/threed/factories/polyline.d.ts.map +1 -0
  341. package/dist-types/threed/factories/rect.d.ts.map +1 -1
  342. package/dist-types/threed/factories/sphere.d.ts +6 -0
  343. package/dist-types/threed/factories/sphere.d.ts.map +1 -1
  344. package/dist-types/threed/factories/sprite.d.ts +20 -12
  345. package/dist-types/threed/factories/sprite.d.ts.map +1 -1
  346. package/dist-types/threed/factories/triangle.d.ts.map +1 -1
  347. package/dist-types/threed/factories/wall.d.ts +20 -12
  348. package/dist-types/threed/factories/wall.d.ts.map +1 -1
  349. package/dist-types/threed/floor/floor.d.ts.map +1 -1
  350. package/dist-types/threed/handle-3d.d.ts +21 -0
  351. package/dist-types/threed/handle-3d.d.ts.map +1 -0
  352. package/dist-types/threed/html/elements.d.ts.map +1 -1
  353. package/dist-types/threed/index.d.ts +28 -0
  354. package/dist-types/threed/index.d.ts.map +1 -1
  355. package/dist-types/threed/managers/box-selection-manager.d.ts +26 -0
  356. package/dist-types/threed/managers/box-selection-manager.d.ts.map +1 -0
  357. package/dist-types/threed/managers/camera-bookmark-manager.d.ts +48 -37
  358. package/dist-types/threed/managers/camera-bookmark-manager.d.ts.map +1 -1
  359. package/dist-types/threed/managers/camera-manager.d.ts +9 -2
  360. package/dist-types/threed/managers/camera-manager.d.ts.map +1 -1
  361. package/dist-types/threed/managers/controls-manager.d.ts +12 -0
  362. package/dist-types/threed/managers/controls-manager.d.ts.map +1 -1
  363. package/dist-types/threed/managers/event-manager3d.d.ts +14 -0
  364. package/dist-types/threed/managers/event-manager3d.d.ts.map +1 -1
  365. package/dist-types/threed/managers/gizmo-manager.d.ts +6 -0
  366. package/dist-types/threed/managers/gizmo-manager.d.ts.map +1 -1
  367. package/dist-types/threed/managers/gizmo-operation-manager.d.ts +54 -1
  368. package/dist-types/threed/managers/gizmo-operation-manager.d.ts.map +1 -1
  369. package/dist-types/threed/managers/index.d.ts +3 -1
  370. package/dist-types/threed/managers/index.d.ts.map +1 -1
  371. package/dist-types/threed/managers/interaction-manager.d.ts +17 -0
  372. package/dist-types/threed/managers/interaction-manager.d.ts.map +1 -1
  373. package/dist-types/threed/managers/light-manager.d.ts +15 -0
  374. package/dist-types/threed/managers/light-manager.d.ts.map +1 -1
  375. package/dist-types/threed/managers/renderer-manager.d.ts +37 -0
  376. package/dist-types/threed/managers/renderer-manager.d.ts.map +1 -1
  377. package/dist-types/threed/managers/scene-manager.d.ts +12 -2
  378. package/dist-types/threed/managers/scene-manager.d.ts.map +1 -1
  379. package/dist-types/threed/managers/types.d.ts +4 -1
  380. package/dist-types/threed/managers/types.d.ts.map +1 -1
  381. package/dist-types/threed/managers/vertex-gizmo-manager.d.ts +154 -0
  382. package/dist-types/threed/managers/vertex-gizmo-manager.d.ts.map +1 -0
  383. package/dist-types/threed/material-3d.d.ts +5 -2
  384. package/dist-types/threed/material-3d.d.ts.map +1 -1
  385. package/dist-types/threed/material-bank.d.ts +42 -0
  386. package/dist-types/threed/material-bank.d.ts.map +1 -0
  387. package/dist-types/threed/material-variant.d.ts +43 -0
  388. package/dist-types/threed/material-variant.d.ts.map +1 -0
  389. package/dist-types/threed/ratio-lock-utils.d.ts +9 -0
  390. package/dist-types/threed/ratio-lock-utils.d.ts.map +1 -0
  391. package/dist-types/threed/real-object-dom-element.d.ts +9 -0
  392. package/dist-types/threed/real-object-dom-element.d.ts.map +1 -1
  393. package/dist-types/threed/real-object-dom-texture.d.ts +9 -1
  394. package/dist-types/threed/real-object-dom-texture.d.ts.map +1 -1
  395. package/dist-types/threed/real-object-external-model.d.ts +24 -0
  396. package/dist-types/threed/real-object-external-model.d.ts.map +1 -0
  397. package/dist-types/threed/real-object-extrude.d.ts +16 -1
  398. package/dist-types/threed/real-object-extrude.d.ts.map +1 -1
  399. package/dist-types/threed/real-object-gltf.d.ts +21 -11
  400. package/dist-types/threed/real-object-gltf.d.ts.map +1 -1
  401. package/dist-types/threed/real-object-group.d.ts +2 -0
  402. package/dist-types/threed/real-object-group.d.ts.map +1 -1
  403. package/dist-types/threed/real-object-line.d.ts +83 -0
  404. package/dist-types/threed/real-object-line.d.ts.map +1 -0
  405. package/dist-types/threed/real-object-mesh.d.ts +0 -1
  406. package/dist-types/threed/real-object-mesh.d.ts.map +1 -1
  407. package/dist-types/threed/real-object-plane-2d.d.ts +23 -1
  408. package/dist-types/threed/real-object-plane-2d.d.ts.map +1 -1
  409. package/dist-types/threed/real-object-service.d.ts +14 -0
  410. package/dist-types/threed/real-object-service.d.ts.map +1 -0
  411. package/dist-types/threed/real-object-sprite.d.ts +7 -2
  412. package/dist-types/threed/real-object-sprite.d.ts.map +1 -1
  413. package/dist-types/threed/real-object-text.d.ts +5 -0
  414. package/dist-types/threed/real-object-text.d.ts.map +1 -1
  415. package/dist-types/threed/real-object.d.ts +276 -7
  416. package/dist-types/threed/real-object.d.ts.map +1 -1
  417. package/dist-types/threed/text-editor-3d.d.ts +11 -0
  418. package/dist-types/threed/text-editor-3d.d.ts.map +1 -0
  419. package/dist-types/threed/texture/canvas-texture.d.ts +7 -0
  420. package/dist-types/threed/texture/canvas-texture.d.ts.map +1 -1
  421. package/dist-types/threed/texture/fillstyle-texture.d.ts +57 -0
  422. package/dist-types/threed/texture/fillstyle-texture.d.ts.map +1 -0
  423. package/dist-types/threed/texture/text-texture.d.ts +15 -0
  424. package/dist-types/threed/texture/text-texture.d.ts.map +1 -1
  425. package/dist-types/threed/three-capability.d.ts +93 -12
  426. package/dist-types/threed/three-capability.d.ts.map +1 -1
  427. package/dist-types/threed/three-container.d.ts.map +1 -1
  428. package/dist-types/threed/threed-enabled.d.ts +5 -0
  429. package/dist-types/threed/threed-enabled.d.ts.map +1 -0
  430. package/dist-types/threed/utils/anchor.d.ts +33 -0
  431. package/dist-types/threed/utils/anchor.d.ts.map +1 -0
  432. package/dist-types/threed/utils/dispose.d.ts.map +1 -1
  433. package/dist-types/threed/utils/polygon-shape.d.ts +21 -0
  434. package/dist-types/threed/utils/polygon-shape.d.ts.map +1 -0
  435. package/dist-types/threed/utils/tether.d.ts +46 -0
  436. package/dist-types/threed/utils/tether.d.ts.map +1 -0
  437. package/dist-types/threed/z-priority.d.ts +27 -0
  438. package/dist-types/threed/z-priority.d.ts.map +1 -0
  439. package/dist-types/tracker/tracker.d.ts +57 -0
  440. package/dist-types/tracker/tracker.d.ts.map +1 -0
  441. package/dist-types/transfer/carrier-line-capability.d.ts +95 -0
  442. package/dist-types/transfer/carrier-line-capability.d.ts.map +1 -0
  443. package/dist-types/transfer/centering-slot-strategy.d.ts +8 -0
  444. package/dist-types/transfer/centering-slot-strategy.d.ts.map +1 -0
  445. package/dist-types/transfer/fixed-slot-strategy.d.ts +8 -0
  446. package/dist-types/transfer/fixed-slot-strategy.d.ts.map +1 -0
  447. package/dist-types/transfer/index.d.ts +25 -0
  448. package/dist-types/transfer/index.d.ts.map +1 -0
  449. package/dist-types/transfer/pickup-helpers.d.ts +75 -0
  450. package/dist-types/transfer/pickup-helpers.d.ts.map +1 -0
  451. package/dist-types/transfer/simulation-clock.d.ts +45 -0
  452. package/dist-types/transfer/simulation-clock.d.ts.map +1 -0
  453. package/dist-types/transfer/tracer.d.ts +35 -0
  454. package/dist-types/transfer/tracer.d.ts.map +1 -0
  455. package/dist-types/transfer/transfer-helpers.d.ts +18 -0
  456. package/dist-types/transfer/transfer-helpers.d.ts.map +1 -0
  457. package/dist-types/transfer/transfer.d.ts +257 -0
  458. package/dist-types/transfer/transfer.d.ts.map +1 -0
  459. package/dist-types/transfer/transferable-mixin.d.ts +275 -0
  460. package/dist-types/transfer/transferable-mixin.d.ts.map +1 -0
  461. package/dist-types/transfer/types.d.ts +462 -0
  462. package/dist-types/transfer/types.d.ts.map +1 -0
  463. package/dist-types/transition/transition-effect.d.ts +117 -0
  464. package/dist-types/transition/transition-effect.d.ts.map +1 -0
  465. package/dist-types/types/bounding.d.ts +1 -1
  466. package/dist-types/types/bounding.d.ts.map +1 -1
  467. package/dist-types/types/capability.d.ts +65 -0
  468. package/dist-types/types/capability.d.ts.map +1 -0
  469. package/dist-types/types/component.d.ts +6 -177
  470. package/dist-types/types/component.d.ts.map +1 -1
  471. package/dist-types/types/event.d.ts +57 -0
  472. package/dist-types/types/event.d.ts.map +1 -1
  473. package/dist-types/types/polygon-path-arc.d.ts +72 -0
  474. package/dist-types/types/polygon-path-arc.d.ts.map +1 -0
  475. package/dist-types/types/polygon-path.d.ts +153 -0
  476. package/dist-types/types/polygon-path.d.ts.map +1 -0
  477. package/package.json +13 -2
  478. package/things-scene-min.js +12 -13
  479. package/things-scene-min.js.map +1 -1
  480. package/things-scene-transfer.mjs +7 -0
  481. package/things-scene.mjs +8 -9
  482. package/things-scene.mjs.map +1 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"contract-inspector.d.ts","sourceRoot":"","sources":["../../src/diagnostics/contract-inspector.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAGrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEzD,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE;QACL,QAAQ,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QAC7C,QAAQ,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KACzD,CAAA;IACD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE/B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,OAAO,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,iBAAiB,IAAI,yBAAyB,EAAE,CAAA;IAEhD,6DAA6D;IAC7D,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,yBAAyB,GAAG;QACrD,YAAY,CAAC,EAAE,GAAG,EAAE,CAAA;QACpB,KAAK,CAAC,EAAE,GAAG,EAAE,CAAA;QACb,mBAAmB,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QACpE,qBAAqB,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAC5D,CAAC,GAAG,IAAI,CAAA;IAET,oBAAoB;IACpB,SAAS,IAAI,kBAAkB,CAAA;IAE/B;;;OAGG;IACH,WAAW,IAAI;QACb,yCAAyC;QACzC,OAAO,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,MAAM,CAAC,CAAA;QAC9C,KAAK,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,KAAK,CAAC,CAAA;QAC3C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC7B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACpC,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAC3C,CAAA;IAED;;;OAGG;IACH,YAAY,IAAI;QACd,OAAO,EAAE,MAAM,CAAA;QACf,GAAG,EAAE,WAAW,EAAE,CAAA;QAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAA;QACzC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAA;KAC1C,CAAA;IAED;;OAEG;IACH,SAAS,IAAI;QACX,OAAO,EAAE,MAAM,CAAA;QACf,GAAG,EAAE,SAAS,GAAG,EAAE,CAAA;QACnB,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;QACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KACnC,CAAA;IAED,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAyFD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,GAAG,GAAG,iBAAiB,CAsJxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,GAAG,GAAG,iBAAiB,CAM1E"}
@@ -0,0 +1,50 @@
1
+ export interface LagMonitorConfig {
2
+ warnThreshold?: number;
3
+ criticalThreshold?: number;
4
+ }
5
+ export type LagLevel = 'normal' | 'warn' | 'critical';
6
+ export interface LagStats {
7
+ current: number;
8
+ baseline: number;
9
+ drift: number;
10
+ min: number;
11
+ max: number;
12
+ sampleCount: number;
13
+ level: LagLevel;
14
+ }
15
+ export declare class DataLagTracker {
16
+ private _current;
17
+ private _min;
18
+ private _max;
19
+ private _count;
20
+ private _baseline;
21
+ private _baselineSet;
22
+ private _baselineSum;
23
+ private _baselineCount;
24
+ private _warn;
25
+ private _critical;
26
+ private _lastLevel;
27
+ private _disposed;
28
+ /** level 변경 시 콜백 (evaluate() 호출 시 트리거). */
29
+ onLevelChange?: (level: LagLevel, stats: LagStats) => void;
30
+ /** 임계값 설정 (선택). */
31
+ configure(config?: LagMonitorConfig | LagMonitorConfig[]): void;
32
+ /**
33
+ * 발행 시각(epoch-ms)을 받아 갭을 기록.
34
+ * `record(ts)` 또는 `record(tag, ts)` 둘 다 허용 — tag 인자는 무시(단일 채널 집계).
35
+ */
36
+ record(a: any, b?: any): void;
37
+ getStats(): LagStats;
38
+ /** UI 갱신 주기 호출 — level 변경 시 콜백 발생. */
39
+ evaluate(): void;
40
+ reset(): void;
41
+ dispose(): void;
42
+ private _calcLevel;
43
+ }
44
+ /**
45
+ * 모듈 레벨 싱글톤 — frameClock 패턴. `globalThis.scene.dataLagTracker` 로 노출되어
46
+ * 모니터 익스텐션/오버레이/구독 핸들러가 동일 인스턴스를 공유한다.
47
+ * (app.lagTracker 도 이 싱글톤을 가리킨다.)
48
+ */
49
+ export declare const dataLagTracker: DataLagTracker;
50
+ //# sourceMappingURL=data-lag-tracker.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"data-lag-tracker.d.ts","sourceRoot":"","sources":["../../src/diagnostics/data-lag-tracker.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAA;AAErD,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,QAAQ,CAAA;CAChB;AAID,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAI;IACpB,OAAO,CAAC,IAAI,CAAW;IACvB,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,KAAK,CAAO;IACpB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,SAAS,CAAQ;IAEzB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAA;IAE1D,mBAAmB;IACnB,SAAS,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,GAAG,IAAI;IAO/D;;;OAGG;IACH,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,IAAI;IAsB7B,QAAQ,IAAI,QAAQ;IAuBpB,sCAAsC;IACtC,QAAQ,IAAI,IAAI;IAShB,KAAK,IAAI,IAAI;IAYb,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,UAAU;CAKnB;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,gBAAuB,CAAA"}
@@ -7,12 +7,9 @@ interface ThreedInfo {
7
7
  resolved?: ResolvedMaterial3D;
8
8
  nodeNames?: string[];
9
9
  animationNames?: string[];
10
- autoPlay?: boolean;
11
10
  nodes?: Record<string, any>;
12
11
  animations?: Record<string, any>;
13
12
  fillStyleTargets?: string[];
14
- spriteMode?: 'billboard' | 'plane';
15
- renderMode?: 'css3d' | 'texture';
16
13
  }
17
14
  interface ComponentTreeNode {
18
15
  id: string;
@@ -25,6 +22,9 @@ interface ComponentTreeNode {
25
22
  name?: string;
26
23
  hidden?: boolean;
27
24
  clazz?: string;
25
+ /** 부모의 *_items (Holdable mixin)_* 자식 — _components 자식과 직교 (Phase 7.2,
26
+ * 2026-06-18). UI 가 별도 marker (icon / color) 로 구분 가능. */
27
+ isItem?: boolean;
28
28
  }
29
29
  interface ComponentInfo {
30
30
  model: object;
@@ -42,6 +42,17 @@ interface ComponentInfo {
42
42
  isContainer: boolean;
43
43
  is3dMode?: boolean;
44
44
  hidden?: boolean;
45
+ /** Holdable mixin 자손 holder 가 _items 보유 시 — runtime carrier 통합 발견.
46
+ * Container-Component 자식 트리 (_components) 와 직교한 별도 자식 시스템. */
47
+ items?: ComponentTreeNode[];
48
+ /** SlottedHolder duck (Phase 7.3, 2026-06-18) — slot 별 점유 상태.
49
+ * duck 자격 = slotIds + occupiedSlotIds + emptySlotIds + hasCarrierAt 의 4 메서드.
50
+ * panel UI 가 *_holder 의 slot 상태 시각화_* (occupied / empty / capacity ratio). */
51
+ slottedHolder?: {
52
+ slotIds: string[];
53
+ occupiedSlotIds: string[];
54
+ emptySlotIds: string[];
55
+ };
45
56
  }
46
57
  declare class SceneInspector {
47
58
  private _scenes;
@@ -50,6 +61,19 @@ declare class SceneInspector {
50
61
  * 모니터링 확장에서 설정하여 Inspector UI를 자동 갱신한다.
51
62
  */
52
63
  onSceneChange: ((sceneCount: number) => void) | null;
64
+ private _watchedComponent;
65
+ private _watchedHandler;
66
+ /**
67
+ * 선택된 컴포넌트의 change 이벤트 콜백.
68
+ * 모니터링 확장에서 설정하여 Inspector UI를 재렌더한다.
69
+ */
70
+ onWatchedComponentChange: ((componentId: string, after: any, before: any) => void) | null;
71
+ /**
72
+ * 선택된 컴포넌트를 설정/해제한다. 이전 구독은 자동 해제된다.
73
+ * componentId === null 이면 구독만 해제.
74
+ */
75
+ setWatchedComponent(componentId: string | null, sceneIndex?: number): boolean;
76
+ private _clearWatched;
53
77
  /**
54
78
  * Scene 인스턴스를 등록한다 (Scene constructor에서 호출).
55
79
  */
@@ -81,8 +105,35 @@ declare class SceneInspector {
81
105
  /**
82
106
  * 특정 컴포넌트의 상세 정보를 반환한다.
83
107
  * componentId가 'root'/'__root__'이면 model_layer 정보를 반환.
108
+ *
109
+ * @param options.includeItems — true 시 _items 자식 시각화 포함 (Phase 7.2).
110
+ * default = false: 자식 tree 의 *_혼동 회피 + 성능 회피_* (carrier 다수 시 매
111
+ * query 마다 _items 자식 모두 traverse). carrier 통합 발견 필요 시 별도 query
112
+ * (`getItems`) 또는 옵션 활성.
113
+ */
114
+ getComponentInfo(componentId: string, sceneIndex?: number, options?: {
115
+ includeItems?: boolean;
116
+ }): ComponentInfo | null;
117
+ /**
118
+ * 컴포넌트의 items list 별도 query — Inspector panel 의 carrier 통합 발견.
119
+ * 자식 트리 (`_components`) 와 직교한 자식 시스템. Holdable mixin 자손만 해당.
120
+ */
121
+ getItems(componentId: string, sceneIndex?: number): ComponentTreeNode[];
122
+ /**
123
+ * 컴포넌트의 records snapshot — `holder.data` 표준 entry (Phase D-7, 2026-06-20).
124
+ *
125
+ * 사용자 vision: *_FlowNode 의 items 는 결국 해당 컴포넌트의 data 로 import/export_*.
126
+ * FlowNode 자손은 ItemsDataBinding 통해 records[] 자동 export (`_items → SlotRecord[]`).
127
+ * RecordStorage 자손은 state.data 직접 반환 (records-only path).
128
+ *
129
+ * monitor-extension panel 측이 이 query 통해 holder 의 records 시각화 — DataSource
130
+ * bind / WMS export 와 같은 schema (`SlotRecord[]`).
131
+ *
132
+ * Inspector 측 carrier 트리 (`getItems` — 인스턴스 list) 와 직교:
133
+ * - getItems → carrier 인스턴스 list (시각 / 도메인)
134
+ * - getRecords → records list (데이터 / 외부 bind 어휘)
84
135
  */
85
- getComponentInfo(componentId: string, sceneIndex?: number): ComponentInfo | null;
136
+ getRecords(componentId: string, sceneIndex?: number): any[];
86
137
  /**
87
138
  * 컴포넌트를 선택한다 (root.selected 설정).
88
139
  * 3D 모드에서 기즈모 attach, 2D 모드에서 selection-layer 연동.
@@ -127,7 +178,7 @@ declare class SceneInspector {
127
178
  getComponentPath(componentId: string, sceneIndex?: number): string[];
128
179
  /**
129
180
  * 컴포넌트의 3D 관련 정보를 반환한다.
130
- * Material3D, GLTF 노드/애니메이션, spriteMode, renderMode 등.
181
+ * Material3D, GLTF 노드/애니메이션 등.
131
182
  */
132
183
  getThreedInfo(componentId: string, sceneIndex?: number): ThreedInfo | null;
133
184
  private _getScene;
@@ -141,6 +192,142 @@ declare class SceneInspector {
141
192
  private _safeBounds;
142
193
  private _safeClone;
143
194
  private _safeValue;
195
+ /**
196
+ * TransferLog 의 aggregated snapshot — Step 1 정공 (2026-06-20).
197
+ *
198
+ * raw 보관 폐기 후 entries 는 항상 빈 array (deprecated, back-compat). 진정한 source =
199
+ * stats / flows / targetCounts / rejectReasonCounts (모두 aggregated O(1)). carrier 별
200
+ * raw timeline 이 필요한 도구는 extension/devtools 가 subscribe 로 자체 누적.
201
+ */
202
+ transferLog(): {
203
+ /** @deprecated raw 보관 폐기. 항상 빈 array. */
204
+ entries: any[];
205
+ stats: {
206
+ total: number;
207
+ committed: number;
208
+ rolledBack: number;
209
+ rejectionRate: number;
210
+ avgTransferDurationMs: number;
211
+ byPhase: Record<string, number>;
212
+ };
213
+ flows: Record<string, number>;
214
+ targetCounts: Record<string, number>;
215
+ rejectReasonCounts: Record<string, number>;
216
+ } | null;
217
+ /** ReservationTable 의 active reservations + groupings. */
218
+ reservations(): {
219
+ simTime: number;
220
+ all: any[];
221
+ byResource: Record<string, any[]>;
222
+ byReserver: Record<string, any[]>;
223
+ } | null;
224
+ /** Conflict 누적 + outcome 통계. */
225
+ conflicts(): {
226
+ simTime: number;
227
+ log: any[];
228
+ total: number;
229
+ rejected: number;
230
+ preempted: number;
231
+ byResource: Record<string, number>;
232
+ byReserver: Record<string, number>;
233
+ } | null;
234
+ /**
235
+ * 단일 component 의 contract 요약 — Phase H/G2 의 markers.
236
+ * existing getComponentInfo 보다 contract 측면에 특화.
237
+ */
238
+ contractSummary(componentId: string, sceneIndex?: number): {
239
+ type: string;
240
+ id: string;
241
+ isItem?: boolean;
242
+ isPickable?: boolean;
243
+ isMover?: boolean;
244
+ isHolder?: boolean;
245
+ toolType?: string;
246
+ pickupFrames?: any[];
247
+ slots?: any[];
248
+ } | null;
249
+ /**
250
+ * Capability discovery — 컴포넌트 인스턴스의 class chain (constructor + 상위
251
+ * prototype) 을 따라가며 static `capabilities` 의 합집합 반환. 컴포넌트가 자기
252
+ * 입으로 선언한 capability 만 사용 (외부 duck-typing 아님).
253
+ *
254
+ * 사용:
255
+ * class Foo extends Component { static capabilities = [...Component.capabilities, 'Foo'] }
256
+ * inspector.getComponentCapabilities(componentId) → ['Foo']
257
+ */
258
+ getComponentCapabilities(componentId: string, sceneIndex?: number): string[];
259
+ /**
260
+ * 단일 컴포넌트의 capability 목록 + 각 capability 의 정적 metadata + 구현자
261
+ * self-description 의 결합 report. 도구가 "이 컴포넌트의 작동 방식 전모" 패널을
262
+ * 그리는 데이터.
263
+ *
264
+ * 각 항목:
265
+ * { name, description, methods, models, sourceFile, instance: { policies, config, ... } }
266
+ *
267
+ * - description/methods/models/sourceFile: capability 자체의 정적 metadata
268
+ * (registerCapabilityMeta 로 등록된 것)
269
+ * - instance: 컴포넌트가 describeCapability(name) 메서드 노출 시 그 결과 — 자기
270
+ * 특화 (정책 / 설정 / 통계)
271
+ */
272
+ componentCapabilityReports(componentId: string, sceneIndex?: number): Promise<any[]>;
273
+ /**
274
+ * System topology — 모든 컴포넌트 + capability-mediated 연결을 한 번에 반환.
275
+ * Monitor 의 Topology panel 이 그래프 한 장 그리는 데 사용.
276
+ *
277
+ * nodes: { id, type, bounds, capabilities }[]
278
+ * edges: { source, target, via }[]
279
+ * via = 'routing-capability' (명시 outbound) | 'data-binding' | 'parent-child'
280
+ */
281
+ systemTopology(sceneIndex?: number, options?: {
282
+ force?: boolean;
283
+ }): Promise<{
284
+ nodes: any[];
285
+ edges: any[];
286
+ issues?: any[];
287
+ }>;
288
+ /**
289
+ * Topology panel 의 *동적 layer* 데이터 — flow (transferLog 의 carrier 이동량) +
290
+ * utilization (각 컴포넌트의 점유율). 1초 polling 부담을 줄이려고 한번에 묶어 반환.
291
+ *
292
+ * flows: { "source>target": count }
293
+ * utilization: { id: { occupied, capacity, ratio } }
294
+ * conflicts: { id: count } // 최근 시간창 안 충돌 카운트
295
+ * distribution: { id: { count, destination?, share?, deviation? } }
296
+ * — Flow Balancing B5: target 별 carrier 도착 누적 + destination 그룹화.
297
+ * 같은 destination 그룹 내 sink 들의 균등성 시각화. share = 그룹 내 비율,
298
+ * deviation = 평균 대비 편차 (0 = 균등, 1 = 단독 점유).
299
+ */
300
+ topologyStats(sceneIndex?: number): Promise<{
301
+ flows: Record<string, number>;
302
+ utilization: Record<string, {
303
+ occupied: number;
304
+ capacity?: number;
305
+ ratio?: number;
306
+ }>;
307
+ conflicts: Record<string, number>;
308
+ distribution: Record<string, {
309
+ count: number;
310
+ destination?: string;
311
+ share?: number;
312
+ deviation?: number;
313
+ }>;
314
+ }>;
315
+ /**
316
+ * 단일 carrier 의 *transfer 여정* — transferLog 에서 그 carrierId 의 entries 를
317
+ * 시간순 정렬해 source → target sequence 반환. Topology 의 Journey 시각화 용.
318
+ *
319
+ * 응답:
320
+ * { carrierId, steps: [{ from, to, at, phase, slotId?, rejectReason? }] }
321
+ */
322
+ carrierJourney(carrierId: string, sceneIndex?: number): Promise<{
323
+ carrierId: string;
324
+ steps: any[];
325
+ }>;
326
+ /**
327
+ * 현재 active 한 carrier id 목록 — Topology UI 의 carrier picker 에 사용.
328
+ * transferLog 에서 *최근 시간창* 안의 unique carrier id 들.
329
+ */
330
+ activeCarrierIds(sceneIndex?: number, limit?: number): Promise<string[]>;
144
331
  }
145
332
  export declare const inspector: SceneInspector;
146
333
  export {};
@@ -1 +1 @@
1
- {"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../../src/diagnostics/inspector.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../../src/diagnostics/inspector.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,82 @@
1
+ export type LoadPhase = 'fetch' | 'parse' | 'init' | 'compile' | 'assets' | 'data' | 'render' | 'complete';
2
+ /** 자동 팝업 표시까지의 대기 시간 (ms) */
3
+ export declare const OVERLAY_DELAY = 5000;
4
+ export interface LoadEntry {
5
+ id: string;
6
+ type: string;
7
+ url: string;
8
+ startTime: number;
9
+ status: 'pending' | 'loaded' | 'timeout' | 'error' | 'cancelled';
10
+ elapsed: number;
11
+ }
12
+ export interface LoadingOptions {
13
+ /** 전체 에셋 로딩 제한 (ms), 0 = 무제한 */
14
+ timeout?: number;
15
+ /** 개별 에셋 제한 (ms), 0 = 무제한 */
16
+ assetTimeout?: number;
17
+ /** 앱에서 미리 생성한 LoadTracker — create()가 새로 만들지 않고 재사용 */
18
+ tracker?: LoadTracker;
19
+ }
20
+ export interface LoadStats {
21
+ total: number;
22
+ loaded: number;
23
+ timeout: number;
24
+ error: number;
25
+ cancelled: number;
26
+ elapsed: number;
27
+ pending: number;
28
+ }
29
+ export interface PhaseRecord {
30
+ phase: LoadPhase;
31
+ timestamp: number;
32
+ elapsed: number;
33
+ duration?: number;
34
+ }
35
+ export declare class LoadTracker {
36
+ private _entries;
37
+ private _phase;
38
+ private _phaseHistory;
39
+ private _options;
40
+ private _startTime;
41
+ private _completedElapsed?;
42
+ private _disposed;
43
+ private _promiseResolve;
44
+ private _promise;
45
+ private _globalTimerId?;
46
+ private _slowTimerId?;
47
+ /** OVERLAY_DELAY 이상 로딩이 지속되었음을 표시 — overlay가 나중에 attach돼도 확인 가능 */
48
+ needsOverlay: boolean;
49
+ /** overlay 표시가 필요할 때 호출되는 콜백 */
50
+ onNeedsOverlay?: () => void;
51
+ /** 콜백 — phase 변경 시 */
52
+ onPhase?: (phase: LoadPhase) => void;
53
+ /** 콜백 — 에셋 완료/에러 시 */
54
+ onProgress?: (stats: LoadStats) => void;
55
+ /** 콜백 — 개별 에셋 타임아웃 시 */
56
+ onTimeout?: (entry: LoadEntry) => void;
57
+ /** 콜백 — complete 시 */
58
+ onComplete?: (stats: LoadStats) => void;
59
+ constructor(options?: LoadingOptions);
60
+ get phase(): LoadPhase;
61
+ get phaseHistory(): PhaseRecord[];
62
+ get progress(): number;
63
+ get pending(): LoadEntry[];
64
+ get entries(): LoadEntry[];
65
+ get stats(): LoadStats;
66
+ get promise(): Promise<void>;
67
+ private _firstRenderDone;
68
+ /** 첫 렌더링 완료 알림 — Layer.__draw__에서 호출 */
69
+ markFirstRender(): void;
70
+ setPhase(phase: LoadPhase): void;
71
+ track(id: string, type: string, url: string, promise: Promise<any>): void;
72
+ checkComplete(): void;
73
+ startGlobalTimeout(): void;
74
+ abort(): void;
75
+ reset(): void;
76
+ dispose(): void;
77
+ private _onEntryDone;
78
+ private _doComplete;
79
+ private _clearEntryTimer;
80
+ private _toPublicEntry;
81
+ }
82
+ //# sourceMappingURL=load-tracker.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"load-tracker.d.ts","sourceRoot":"","sources":["../../src/diagnostics/load-tracker.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,98 @@
1
+ import type { LoadEntry, LoadStats, LoadPhase, PhaseRecord } from './load-tracker.js';
2
+ import type { LoadTracker } from './load-tracker.js';
3
+ import type { DataLagTracker, LagStats } from './data-lag-tracker.js';
4
+ /** 매 tick 렌더러에 전달되는 데이터 스냅샷(코어가 tracker 에서 조립). */
5
+ export interface LoadingOverlayState {
6
+ phase: LoadPhase;
7
+ isComplete: boolean;
8
+ stats: LoadStats;
9
+ phaseHistory: PhaseRecord[];
10
+ pending: LoadEntry[];
11
+ entries: LoadEntry[];
12
+ /** 데이터 래깅 통계 — lagTracker 미제공 또는 표본 없으면 undefined. */
13
+ lag?: LagStats;
14
+ }
15
+ /** 렌더러가 오버레이 수명주기를 제어하는 훅(닫기/취소 버튼 등). */
16
+ export interface LoadingOverlayHost {
17
+ hide(): void;
18
+ cancel(): void;
19
+ }
20
+ /**
21
+ * 로딩 오버레이 렌더러 — DOM 표현을 전담. 코어(LoadingOverlay)가 build()로 1회 DOM 을 만들게 하고,
22
+ * 표시 중 매 tick update(state)로 갱신한다. 호스트는 이 인터페이스 구현체를 주입해 형태를 커스터마이즈.
23
+ */
24
+ export interface LoadingOverlayRenderer {
25
+ /** container(전체 크기 오버레이 레이어) 안에 DOM 을 1회 구성. host 로 닫기/취소 연결. */
26
+ build(container: HTMLElement, host: LoadingOverlayHost): void;
27
+ /** 현재 상태로 DOM 갱신(표시 중 500ms 주기). */
28
+ update(state: LoadingOverlayState): void;
29
+ /** 정리(선택). */
30
+ destroy?(): void;
31
+ }
32
+ export declare class LoadingOverlay {
33
+ private _tracker?;
34
+ private _lagTracker?;
35
+ private _container?;
36
+ private _built;
37
+ private _targetElement?;
38
+ private _updateTimer?;
39
+ private _visible;
40
+ private _manualOpen;
41
+ private _renderer;
42
+ /**
43
+ * 로딩 취소 콜백. 호스트(앱)가 "무엇이 취소인지"를 정의한다.
44
+ * 미지정 시 window.history.back()(뒤로가기)으로 폴백한다.
45
+ */
46
+ onCancel?: () => void;
47
+ /** 표현 렌더러 — 교체 시 다음 표시에서 새 렌더러로 재구성. 기본은 DefaultLoadingOverlayRenderer. */
48
+ get renderer(): LoadingOverlayRenderer;
49
+ set renderer(r: LoadingOverlayRenderer);
50
+ attach(targetElement: HTMLElement, tracker?: LoadTracker, lagTracker?: DataLagTracker): void;
51
+ toggle(): void;
52
+ show(): void;
53
+ hide(): void;
54
+ destroy(): void;
55
+ get isVisible(): boolean;
56
+ get isAttached(): boolean;
57
+ private _teardownContainer;
58
+ private get _host();
59
+ private _show;
60
+ private _hide;
61
+ private _update;
62
+ /** tracker 들에서 렌더러가 소비할 상태 스냅샷을 조립(lagTracker 는 evaluate 부작용 포함). */
63
+ private _assembleState;
64
+ /** 로딩 취소 — 오버레이를 닫고, onCancel 지정 시 그것을, 아니면 브라우저 뒤로가기. */
65
+ private _cancel;
66
+ }
67
+ export declare class DefaultLoadingOverlayRenderer implements LoadingOverlayRenderer {
68
+ private _headerEl?;
69
+ private _progressFillEl?;
70
+ private _progressTextEl?;
71
+ private _phaseListEl?;
72
+ private _phaseRenderedCount;
73
+ private _pendingListEl?;
74
+ private _lagSectionEl?;
75
+ private _footerRowEl?;
76
+ build(container: HTMLElement, host: LoadingOverlayHost): void;
77
+ update(state: LoadingOverlayState): void;
78
+ destroy(): void;
79
+ private _updateProgress;
80
+ private _updatePhaseList;
81
+ private _updateAssetList;
82
+ private _updateLagDisplay;
83
+ private _renderHistorySummary;
84
+ /**
85
+ * 게이지 좌표 계산 — baseline 은 항상 트랙 중심(50%), 좌우 대칭 스케일로 매핑.
86
+ * 반경 R = 중심에서 더 먼 극단까지 거리, 최소 ±1초 floor.
87
+ * cur<baseline→왼쪽(leading), cur>baseline→오른쪽(lagging).
88
+ */
89
+ private _lagGauge;
90
+ /** 중심(50%)→cur 채움 막대의 left/width CSS. */
91
+ private _lagFill;
92
+ private _renderLagSection;
93
+ private _createPendingRow;
94
+ private _updatePendingRow;
95
+ private _updateLagSection;
96
+ private _shortUrl;
97
+ }
98
+ //# sourceMappingURL=loading-overlay.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"loading-overlay.d.ts","sourceRoot":"","sources":["../../src/diagnostics/loading-overlay.ts"],"names":[],"mappings":"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"}
@@ -8,6 +8,12 @@ interface ResidentData {
8
8
  }>;
9
9
  }
10
10
  declare class SceneMetrics {
11
+ /**
12
+ * Opt-in 게이트. 디폴트 OFF — Chrome 확장이 없을 때 hot path 측정 비용 0.
13
+ * 확장의 injected.js 가 scene 발견 시 enable() 호출.
14
+ * 확장 미설치 사용자는 카운터 증가 / performance.now() / FrameClock 측정 모두 건너뜀.
15
+ */
16
+ enabled: boolean;
11
17
  drawCount: number;
12
18
  drawTimeSum: number;
13
19
  drawTimeLast: number;
@@ -18,6 +24,10 @@ declare class SceneMetrics {
18
24
  private _lastSnapshotTime;
19
25
  private _frameCount;
20
26
  private _getResidents;
27
+ /** 측정 활성화 — 누적된 stale 카운터를 리셋하고 게이트를 켠다. */
28
+ enable(): void;
29
+ /** 측정 비활성화 — hot path 다시 0 비용. */
30
+ disable(): void;
21
31
  /**
22
32
  * Component/Scene/ReferenceMap에서 resident 데이터를 제공하는 함수를 등록한다.
23
33
  * things-scene/index.ts에서 모든 모듈 로드 후 1회 호출.
@@ -1 +1 @@
1
- {"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/diagnostics/metrics.ts"],"names":[],"mappings":"AAQA,UAAU,YAAY;IACpB,uBAAuB,EAAE,MAAM,CAAA;IAC/B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,0BAA0B,EAAE,MAAM,CAAA;IAClC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC7D;AAED,cAAM,YAAY;IAEhB,SAAS,SAAI;IACb,WAAW,SAAI;IACf,YAAY,SAAI;IAGhB,eAAe,SAAI;IAGnB,YAAY,SAAI;IAGhB,QAAQ,SAAI;IACZ,SAAS,SAAI;IAGb,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,WAAW,CAAI;IAGvB,OAAO,CAAC,aAAa,CAAoC;IAEzD;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,YAAY;IAI5C;;;OAGG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;OAIG;IACH,QAAQ;;;;;gBA/C6B,MAAM;kBAAQ,MAAM;;;;;;;;;;CAwF1D;AAED,eAAO,MAAM,OAAO,cAAqB,CAAA"}
1
+ {"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/diagnostics/metrics.ts"],"names":[],"mappings":"AAQA,UAAU,YAAY;IACpB,uBAAuB,EAAE,MAAM,CAAA;IAC/B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,0BAA0B,EAAE,MAAM,CAAA;IAClC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC7D;AAED,cAAM,YAAY;IAChB;;;;OAIG;IACH,OAAO,UAAQ;IAGf,SAAS,SAAI;IACb,WAAW,SAAI;IACf,YAAY,SAAI;IAGhB,eAAe,SAAI;IAGnB,YAAY,SAAI;IAGhB,QAAQ,SAAI;IACZ,SAAS,SAAI;IAGb,OAAO,CAAC,iBAAiB,CAAI;IAC7B,OAAO,CAAC,WAAW,CAAI;IAGvB,OAAO,CAAC,aAAa,CAAoC;IAEzD,4CAA4C;IAC5C,MAAM,IAAI,IAAI;IAad,kCAAkC;IAClC,OAAO,IAAI,IAAI;IAIf;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,YAAY;IAI5C;;;OAGG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;OAIG;IACH,QAAQ;;;;;gBAzE6B,MAAM;kBAAQ,MAAM;;;;;;;;;;CAsH1D;AAED,eAAO,MAAM,OAAO,cAAqB,CAAA"}
@@ -1,3 +1,5 @@
1
- export declare function setShadow(context: CanvasRenderingContext2D, shadow: any, component: any): void;
1
+ import type { Component } from '../types/component';
2
+ import type { Shadow } from '../interfaces/rendering';
3
+ export declare function setShadow(context: CanvasRenderingContext2D, shadow: Shadow, component: Component): void;
2
4
  export declare function resetShadow(context: CanvasRenderingContext2D): void;
3
5
  //# sourceMappingURL=shadow.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"shadow.d.ts","sourceRoot":"","sources":["../../src/effect/shadow.ts"],"names":[],"mappings":"AAWA,wBAAgB,SAAS,CAAC,OAAO,EAAE,wBAAwB,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,QASvF;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,wBAAwB,QAE5D"}
1
+ {"version":3,"file":"shadow.d.ts","sourceRoot":"","sources":["../../src/effect/shadow.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AA6CrD,wBAAgB,SAAS,CACvB,OAAO,EAAE,wBAAwB,EACjC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,GACnB,IAAI,CAWN;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAEnE"}
@@ -4,5 +4,6 @@ import './shift-handler.js';
4
4
  import './zoom-handler.js';
5
5
  import './paste-handler.js';
6
6
  import './waypoint-handler.js';
7
+ import './transition-handler.js';
7
8
  export { default as EventMap } from './event-map.js';
8
9
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/event-map/index.ts"],"names":[],"mappings":"AAIA,OAAO,uBAAuB,CAAA;AAC9B,OAAO,mBAAmB,CAAA;AAC1B,OAAO,oBAAoB,CAAA;AAC3B,OAAO,mBAAmB,CAAA;AAC1B,OAAO,oBAAoB,CAAA;AAC3B,OAAO,uBAAuB,CAAA;AAE9B,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAA"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/event-map/index.ts"],"names":[],"mappings":"AAIA,OAAO,uBAAuB,CAAA;AAC9B,OAAO,mBAAmB,CAAA;AAC1B,OAAO,oBAAoB,CAAA;AAC3B,OAAO,mBAAmB,CAAA;AAC1B,OAAO,oBAAoB,CAAA;AAC3B,OAAO,uBAAuB,CAAA;AAC9B,OAAO,yBAAyB,CAAA;AAEhC,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAA"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=transition-handler.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transition-handler.d.ts","sourceRoot":"","sources":["../../src/event-map/transition-handler.ts"],"names":[],"mappings":""}
@@ -0,0 +1,36 @@
1
+ import { type SegmentTopology, type SegmentBounds, type MatchTolerance } from './segment-topology.js';
2
+ interface SegmentLike {
3
+ state?: {
4
+ id?: string;
5
+ };
6
+ parent?: any;
7
+ rootModel?: any;
8
+ root?: any;
9
+ getSegmentTopology(): SegmentTopology;
10
+ }
11
+ /**
12
+ * Component tree 의 *_getSegmentTopology 를 노출하는 component_* 모두 수집.
13
+ * 자기 자신 제외. id 없는 컴포넌트 제외 (= downstreamRef target 으로 사용 불가).
14
+ *
15
+ * traversal 시작점 — *_self.parent_* (= model-layer 등 sibling 영역). 만약
16
+ * sibling 만으로 부족하면 *_rootModel 또는 root 의 재귀 descend_* 까지. things-
17
+ * scene 의 root 는 RootContainer 라 *_.components 가 layer 들_*만 — 우리 segment
18
+ * 는 model-layer 자식 이므로 sibling 또는 재귀 필요.
19
+ */
20
+ export declare function collectAdjacentSegments(startRoot: any, exclude: any): Array<{
21
+ id: string;
22
+ topology: SegmentTopology;
23
+ bounds?: SegmentBounds;
24
+ }>;
25
+ /**
26
+ * 자기 outbound 의 *_가장 가까운 downstream segment id_*. inbound 가진 후보들
27
+ * 만 매칭. multi-outbound segment 의 경우 outbound[0] 만 — 분기 segment 는
28
+ * 자체 logic 으로 override 권장.
29
+ *
30
+ * traversal 시작점: self.parent (= 직접 sibling 영역) 우선, 부재 시 rootModel
31
+ * → root fallback. RootContainer 의 .components 가 layer 들이라 *_재귀 descend_*
32
+ * 까지 처리하는 collectAdjacentSegments 사용.
33
+ */
34
+ export declare function inferDownstreamId(self: SegmentLike, tolerance?: MatchTolerance): string | null;
35
+ export {};
36
+ //# sourceMappingURL=auto-route.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"auto-route.d.ts","sourceRoot":"","sources":["../../src/flow/auto-route.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAkB,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAErH,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACvB,MAAM,CAAC,EAAE,GAAG,CAAA;IACZ,SAAS,CAAC,EAAE,GAAG,CAAA;IACf,IAAI,CAAC,EAAE,GAAG,CAAA;IACV,kBAAkB,IAAI,eAAe,CAAA;CACtC;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,GAAG,EACd,OAAO,EAAE,GAAG,GACX,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAC;IAAC,MAAM,CAAC,EAAE,aAAa,CAAA;CAAE,CAAC,CAmC1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,EACjB,SAAS,CAAC,EAAE,cAAc,GACzB,MAAM,GAAG,IAAI,CAwBf"}