frankaa
/frankaa
Dodaje lub naprawia suwaki zdjęć i podglądy pełnoekranowe w pakiecie frankaa, w tym karuzele z przesuwaniem, lightboxy i przejścia GLSL.
- Autor
- JABClari ↗
- Repozytorium
- frankaa ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 13.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Dodaje lub naprawia suwaki zdjęć i podglądy pełnoekranowe w pakiecie frankaa, w tym karuzele z przesuwaniem, lightboxy i przejścia GLSL.
Oryginalny opis (EN)
Add or fix photo sliders and photo lightboxes with the frankaa package (procession slider, unfurl lightbox, React bindings, WebGL or CSS renderer, custom GLSL transition shaders). Use when a project needs a swipeable photo carousel, a listing-card photo slider, a gallery grid that opens a fullscreen lightbox, image transition effects, or when frankaa is already a dependency.
Jak działa
- Steps
- Decisions
- Checklist
Podgląd SKILL.md
---
name: frankaa
description: Add or fix photo sliders and photo lightboxes with the frankaa package (procession slider, unfurl lightbox, React bindings, WebGL or CSS renderer, custom GLSL transition shaders). Use when a project needs a swipeable photo carousel, a listing-card photo slider, a gallery grid that opens a fullscreen lightbox, image transition effects, or when frankaa is already a dependency.
---
# frankaa
frankaa is a zero-dependency photo slider (`procession`) and lightbox (`unfurl`) with thin React bindings. Full reference: `node_modules/frankaa/llms-full.txt` (read it before writing code). Agent rules: `node_modules/frankaa/AGENTS.md`.
## Steps
1. Install: `npm install frankaa` (explain to the person that it is a runtime dependency with no dependencies of its own).
2. Import the styles once: `import "frankaa/style.css"`.
3. Pick the import: `frankaa/slider`, `frankaa/lightbox`, `frankaa` (both) or `frankaa/react`.
4. Wire it:
- Slider: `procession(element, { photos, label })`, or `<Procession photos label ref />` in React.
- Lightbox: `unfurl({ photos, start, origin: (n) => thumbElement(n) })`, or `useUnfurl(photos, { origin })` then `open(i)`.
- Slider opening the lightbox: `onSelect: (i) => unfurl({ photos, start: i, origin: (n) => slider.image(n), onChange: (n) => slider.go(n, false) })`.
5. In Next.js or any SSR framework, use it only in client components and never at module top level.
6. Verify with the checklist below.
## Decisions
- `renderer: "auto"` (default). Use `"css"` for cross-origin photos without CORS headers, or when WebGL is unwanted.
- Effects: `"displacement"` (default), `"ripple"`, `"fade"`, `"zoom"`, `"none"`, or a custom shader.
- Custom shader: GLSL ES 1.0 fragment with `precision mediump float;`, `vUv`, `uFrom`, `uTo`, `uProgress`, `uResolution`, `uFromSize`, `uToSize`, `uTime`, `uDirection`, own uniforms; output `gl_FragColor`; macros `coverUv()` and `mirrorUv()`. Register with `registerEffect(name, { fragment, uniforms })`, check with `checkEffect()`. Compile errors fire `onError` and fall back to CSS. Never compile shader source from users.
- Videos: items `{ type: "video", provider: "youtube" | "vimeo" | "tiktok" | "instagram" | "mp4", src, poster }`; players load on tap; add providers to CSP `frame-src`.
- Extra top-bar buttons: `topActions` or `controls`; React `renderControls` and render `{lightbox.portal}`. Never inject into the dialog by DOM query.
- `destroy()` fires the close hooks with `reason: "destroy"`.
- Zoom is on in the lightbox (pinch, double tap, Ctrl+wheel); slider zoom is opt-in (`zoom: true`). Slider links: `href`, `tabbable: false`, `focusRing: "inset"` in clipped cards. Theme with `--fk-*` properties.
- One items list for every part: `{ src, thumb?, full?, alt }`. Combining is one option: `unfurl(items, { strip: "ruler" })`; `drumline(el, items, { preset })` opens the lightbox on tap. React: `<Drumline items preset />`, `useUnfurl(items, { strip })`.
- drumline presets "ruler" | "numbers" | "minimal"; `fluid` "off" | "lerp" | "chain" | "bend" (WebGL with a DOM fallback).
- Autoplay off, `reducedMotion: "system"`, unless the person asks.
- Translate with `labels` (`{n}` and `{total}` placeholders).
- Listen with hooks (`onOpenStart`, `onOpenEnd`, `onCloseStart`, `onCloseEnd`, `onChange`, `onSlideChange`, `onAnimationStart`, `onAnimationEnd`, `onError`) or DOM events `frankaa:<kebab-name>`.
## Checklist
- Styles imported; slider has an aspect ratio or height (no layout shift); photos have `alt`, `width`, `height`.
- Keyboard: slider arrows and Enter; lightbox arrows, Escape, Tab trapped, focus returns on close.
- Reduced motion gives a fade; thumbnails spring out and back; no console errors or `frankaa:error` events.
Wersje
W bazie nie ma innych skilli o nazwie frankaa.
Migawka bazy z 13.11.2026 · wersja paczki 1e3d8badb0c0 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100gpuslider
Dodaje slider, karuzelę, galerię lub lightbox obrazów i wideo z przejściami na shaderach GPU (liquid, burn, glitch) w czystym JS, React i Next.js. - 90carousel
Projektuje, optymalizuje i audytuje karuzele i slidery do treści: galerie, opinie, cytaty i dostępność. - 95image-sphere
Buduje w three.js kulę ze zdjęciami, które dryfują, obracają się po przeciągnięciu i po kliknięciu powiększają wybrane zdjęcie w podglądzie. - 91apple-hig-sliders
Pomaga projektować suwaki do ciągłej regulacji: skale, precyzyjne wpisywanie wartości i podgląd na żywo. - 100fe-a11y-carousel-toast
Buduje karuzele, suwaki treści i powiadomienia, które można zatrzymać, obsłużyć z klawiatury i usłyszeć, zgodnie ze wzorcami WAI-ARIA. - 100gallery
Tworzy galerie zdjęć z kuracją układu wspomaganą przez AI, koordynując skrypty i subagenty.