@perxona/presenter-types

TypeScript type definitions for Perxona's presenter Web Component (currently registered as <sv-presenter>). This package ships types only — install it purely for editor autocomplete and compile-time checking. The presenter itself always runs from Perxona's CDN; this package never bundles or executes any presenter code.

• Website: perxona.ai
• Perxona Connect Kit Handbook: connect.perxona.ai
• Samples: github.com/XRSPACE-Inc/perxona-connect-kit

Why types and implementation ship separately

• The presenter implementation evolves alongside the backend. Rather than asking integrators to track and re-pin versions by hand, the CDN build always serves the version the backend currently supports — so your integration keeps working without manual upgrades, and never drifts out of sync with what the backend actually expects.
• Some integrators embed the presenter with plain HTML and no bundler — a CDN <script> tag is the only integration path available to them.

Install

npm install @perxona/presenter-types@latest

This package's version number tracks the CDN presenter contract as it evolves over time, not a traditional semver compatibility promise. Because it ships types only, the worst case of an update is a compile-time type error, never a runtime break — so re-run npm install @perxona/presenter-types@latest periodically (rather than relying on a version pinned once in your lockfile) to keep your types matching what the CDN presenter actually serves.

Usage

/** @type {HTMLElement & import('@perxona/presenter-types').IPresentationWidget} */
const presenter = document.querySelector('sv-presenter');