@figurosity/consumer-three-dimension-tool

3D pose viewer for the Figurosity consumer frontend ecosystem. Mounts a three.js scene against a base-pose envelope and exposes a TdPage component plus the underlying Pinia stores.

This is the Vite library successor to the legacy @figurosity/quasar-app-extension-three-dimension-tool (preserved at figurosity/three-dimension-tool — never published, never installed in fe/app). Restructured 2026-04-25 per Stage 4c of the consumer-frontend cleanup plan and Phase 0 of the unified 360 + 3D viewer initiative.

Install

npm install @figurosity/consumer-three-dimension-tool

Peer dependencies: vue, quasar, pinia, vue-router, vue-coloris, three, lodash.isequal, @figurosity/toolbox, @figurosity/consumer-controls.

Public API

import {
  TdPage,
  use3dStore,
  useColorsStore,
  useControlsStore,
  useFBXStore,
  useGridStore,
  useGroundStore,
  useLightsStore,
  useSceneStore,
} from '@figurosity/consumer-three-dimension-tool'

The host app provides:

• A Pinia instance and a Quasar runtime
• The Symbol.for('RelatedSection') injection key (provide(...) — shared with consumer-three-sixty-tool so the host can register a single component for both viewers)

The library produces 8 Pinia stores keyed 3d, 3d-fbxs, 3d-colors, 3d-controls, 3d-grid, 3d-ground, 3d-lights, 3d-scene. Drive scene state by calling tdStore.setFromResponse(envelope) with a { entities, result } envelope shape.

Local development

npm install
npm run build       # emits dist/consumer-three-dimension-tool.js (ESM)
npm run dev         # opens the dev playground (Vite SPA in dev/)
npm test            # vitest smoke suite
npm run lint        # eslint

The dev playground at dev/ mounts TdPage against a fixture envelope. It runs independently of fe/app. The fixture sets the FBX URL to null — Phase 4 of the unified-viewer initiative replaces FBX with GLB and ships a real model fixture.

Documentation

• docs/tech-stack.md — build configuration, dependency rationale
• docs/quasar-usage.md — Quasar primitives the package consumes (seed for future coupling-reduction work)
• docs/three-usage.md — three.js imports, FBX loader sites, Phase-4 GLB migration surface

License

UNLICENSED — proprietary, not for redistribution.