TypeScript

Tipler paketle birlikte gelir (dist/types). @types kurulumu gerekmez.

import { InsigneSlider, type Options, type ChangeDetail, type SliderSpec } from 'insigne-slider';

const options: Options = { effect: 'fade', autoplay: 5000, breakpoints: { 768: { effect: 'cube' } } };
const slider = new InsigneSlider('#hero', options);

slider.on('change', (d: ChangeDetail) => {
  d.index;    // number
  d.previous; // number
  d.slide;    // HTMLElement
});

Dışa aktarılan tipler

Tip	Açıklama
Options	Constructor, update() ve create()'in kabul ettiği ayar nesnesi. Her ayar açıklamasıyla JSDoc'ta.
OptMeta	Bir ayarın meta verisi (name, type, default, values, min, max, group).
EventName	'ready' | 'change' | 'movestart' | 'moveend' | 'resize' | 'autoplay' | 'refresh' | 'destroy'
ChangeDetail	{ index, previous, slide, slider }
SliderSpec, SlideSpec, LayerSpec, BgSpec	JSON şeması tipleri.

JSX / şablonlarda eleman

// global.d.ts — TSX'te tipli <insigne-slider>
import type { InsigneSliderElement } from 'insigne-slider';

declare global {
  interface HTMLElementTagNameMap {
    'insigne-slider': InsigneSliderElement;
  }
}

Yerleşim matematiği

smartFit(W, H, görselG, görselY, mod, odak, güvenli) → { left, top, width, height, gaps }; slider'ın kullandığı fonksiyonun aynısı. Bir CMS'te kırpma önizlemesi için kullanışlı:

import { smartFit, parseFocus, parseSafe } from 'insigne-slider';

const p = smartFit(375, 600, 1600, 900, 'smart', parseFocus('30% 40%'), parseSafe('10 15 40 70'));