Pnevma-tools

Pnevma Tools

Modern Next.js TypeScript migration of the original standalone Pnevma Tools HTML calculators.

Owner: Pnevma.

Tools

• CO2 Laser Spot Diameter Calculator: source presets, lens shape, finish comparison, mirror path losses, alignment, smoke/extraction, beam expander checks, and inline SVG graphs.
• Laser Axis Line Interval Calculator: motor microsteps, controller steps/mm, linked DPI/line interval inputs, clean interval checks, spot overlap, and inline SVG interval graph.

Install

npm install

Development

npm run dev

Open the local URL printed by Next.js, usually http://localhost:3000.

Build

npm run build
npm run start

Tests

npm run test

REST Endpoints

• POST /api/spot/calculate: accepts SpotInputs, validates the payload, calls calculateSpot, and returns SpotResult.
• POST /api/axis/calculate: accepts AxisInputs, validates the payload, calls calculateAxis, and returns AxisResult.
• GET /api/config: returns static UI config, defaults, source presets, lens/mirror/finish presets, labels, options, and notices.

The API routes are thin wrappers. Calculator math lives in lib/calculators.

Migration Notes

• Source HTML files used for this migration were the standalone index.html, co2-spot-calculator.html, and axis-line-interval-calculator.html.
• Static source, finish, lens, mirror, option, label, default, and notice data were extracted into typed modules under lib/data.
• The old iframe and postMessage workspace was replaced with direct React routes and shared settings context.
• Graphs remain inline SVG. No charting library is used.
• No GraphQL, database, authentication, Tailwind, shadcn/ui, browser Babel, UMD React scripts, iframe, or charting package is included.

Important Notice

These calculators are workshop planning aids. They are not certified metrology, safety, medical, legal, or compliance tools. Validate important machine settings with real measurements, test cuts, burn tests, manufacturer documentation, and normal laser safety procedures.

Pnevma provides the tools without warranty.