@vived/component-spot-welder-eoat

Spot Welder EOAT — VIVED Smart Component

A reusable 3D spot welder end-of-arm tool (EOAT) for VIVED slide apps. Models an actuated welding tip that extends and retracts, with automatic spark particle effects when the tip reaches the contact point.

Installation

npm install @vived/component-spot-welder-eoat @vived/core @babylonjs/core

Peer dependencies:

• @babylonjs/core ^9.0.0
• @vived/core ^2.0.0

Usage

import {
  createBabylonSpotWelderEOT,
  makeSpotWelderEOTFeatureFactory,
  setTipPosition,
} from "@vived/component-spot-welder-eoat";
import { makeAppObjectRepo, makeDomainFactoryRepo } from "@vived/core";

const appObjects = makeAppObjectRepo();
const domainFactoryRepo = makeDomainFactoryRepo(appObjects);

makeSpotWelderEOTFeatureFactory(appObjects);
domainFactoryRepo.setupDomain();

const view = await createBabylonSpotWelderEOT("welder-1", appObjects);

if (view) {
  // Extend tip to 50% (0 = retracted, 1 = fully extended)
  setTipPosition("welder-1", 0.5, appObjects);
}

Development

npm install
npm run dev          # playground dev server
npm run dev:watch    # library watch build
npm run test         # run tests
npm run lint         # lint source
npm run build        # production build

Asset Upload Script

The repository includes a reusable CLI script for uploading component assets to the VIVED Asset System.

npm run upload-asset -- create <filePath>
npm run upload-asset -- update <assetId> <filePath>

After creating an asset, update the ID in src/component.config.ts.

Documentation

• See COMPONENT_KNOWLEDGE.md for the full consumer API reference, quick start, and recipes.
• See COMPONENT_ARCHITECTURE.md for internal design decisions and contributor notes.