[pythonlearner1025]

What part this touches

The editor's left panel, in packages/editor. Today it has four tabs: Objects, Materials, Textures, Geometries. Objects shows the three.js object tree of the active document. The other three list the resources that document holds. A resource is shared: one material can serve many meshes, so the lists show each resource once, and the Objects tree never shows which resource a mesh uses. The Inspector on the right shows the selected object or resource. The Files and Library bottom panel is not touched.

The tab strip is declared in ThreeEditorComponent.tsx. The Objects tree is BPHierarchyComponent.tsx. The three resource trees are BPMaterialsTreeComponent.tsx, BPTexturesTreeComponent.tsx, and BPGeometriesTreeComponent.tsx.

The problem

1. Select a mesh in Objects. The tree row shows a name and nothing else. The Inspector shows its material, but the tree does not.
2. To see what else uses that material, switch to the Materials tab and search by name. Nothing links the two views.
3. Three separate resource tabs split one question, "what does this document hold", across three clicks.
4. Double-click on a placed asset root only frames the camera. Opening the asset's own document takes the Inspector's Edit Asset button.

The owner's words: "why can't i visually see what resources are applied to a particular node? can't this be shown as children of this node?"

The fix

• Materials, Textures, and Geometries become one Resources tab with three collapsible sections and count badges. The three trees stay as components and the new tab composes them.
• Under a mesh, line, or points row, the Objects tree shows reference rows, built when the row expands: its geometry, its material, one row per material in an array, one row per assigned texture slot under each material, and one row per entity component.
• A reference row is icon only. The icon says geometry, material, texture, or component. The texture slot name lives in the tooltip.
• A reference row is italic, carries a link glyph, is not draggable, and has no context actions. It is a reference, not a child. A shared material shows under every mesh that uses it.
• Click on a reference row selects that resource. The Inspector shows it. The Objects tree keeps its scroll and expansion.
• Double-click on a reference row switches the left panel to Resources with that row selected and scrolled into view.
• Double-click on an asset root opens that asset's document through store.open, the same call the Inspector's Edit Asset button makes.
• Preview-rig lights in asset documents render dimmed in the Objects tree.
• One list builder, sceneResources.ts, feeds the three sections. One click path, selectResource.ts, serves the trees and the reference rows.

The risk trade

• Double-click on an asset root no longer frames the camera. It opens the document. The f key still frames. This follows the owner's mockup.
• Reference rows refresh on the events the Objects tree already uses. A material rename shows on the next tree refresh, not instantly.
• A component row selects its object, because a component has no Resources row. Its double-click does not switch tabs.
• The Materials section lists every material instance the importer created, as the Materials tab did before. A document with 160 copies of "Map concrete" shows 160 rows. Merging by identity is a separate change.
• Reference rows build on expand, not up front, so a large scene pays nothing until a mesh is opened.
• Rejected alternative: a fourth tab that lists references for the selected object. It would keep the two views apart, which is the problem.

Tests

• npm run typecheck, npm run lint, npm run build:editor: all exit 0.
• No unit tests were added. The repo adds tests only for flaky manual behaviour or a user-reported bug.
• Headless walkthrough with Playwright against a read-only clone of the terminator project, in ~/games/terminator-evidence/docs/evidence/kite3d-resources-tab/ with 14 screenshots and walkthrough.log:
  • Left tabs: Objects, Resources. Badges: Materials 160, Textures 447, Geometries 402. Section rows 1009, and the sums agree.
  • An Endo mesh lists its geometry, its material, and five texture slots: map, aoMap, normalMap, roughnessMap, metalnessMap. The same material appears under both Endo meshes.
  • Reference rows report draggable=false and zero context items. Object rows keep draggable=true and five items.
  • Click puts the material in the Inspector. Double-click opens Resources with the row selected and in view.
  • A collapsed section stays collapsed after a reload.
• Without the fix the tab strip has four tabs, and a mesh row has no children.

Deploy

The editor ships inside the @kite3d/editor and kite3d packages. Nothing ships from this PR until it lands on main and a release runs.

git checkout main && git pull
npm run build
npm run release:dry
npm run release

The game links the engine by file path, so a rebuilt packages/editor/dist reaches the local editor on the next restart of npx kite3d dev.

Rollback: revert the squash commit on main, rebuild, and release the next alpha.

git revert <squash sha>

🤖 Generated with Claude Code