@konce-pt/backdrop 0.12.0 → 0.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,11 +1,11 @@
1
1
  <p align="center">
2
- <img src="https://ui.konce.pt/images/koncept_ui_lib.png" alt="Koncept UI — Angular component library" width="100%" />
2
+ <img src="https://ui.konce.pt/images/koncept_ui_lib.png" alt="Koncept UI - Angular component library" width="100%" />
3
3
  </p>
4
4
 
5
5
  # @konce-pt/backdrop
6
6
 
7
7
  Animowane tło [Koncept UI](https://gitlab.com/konce-pt/koncept-ui) to dekoracyjna warstwa pod
8
- sekcję — rysowana na canvasie zamiast wczytywana jako obraz, więc nie kosztuje transferu, skaluje
8
+ sekcję - rysowana na canvasie zamiast wczytywana jako obraz, więc nie kosztuje transferu, skaluje
9
9
  się bez rozdzielczości i bierze kolory z tokenów motywu.
10
10
 
11
11
  Ta paczka jest jego rdzeniem: układ siatki i rampa gęstości efektu **signal-grid**, płynąca wstęga
@@ -23,7 +23,7 @@ npm i @konce-pt/backdrop
23
23
  ```ts
24
24
  import { createBackdropRenderer } from '@konce-pt/backdrop';
25
25
 
26
- // Renderer żyje tyle, co jeden zestaw ustawień — zmiana wejść buduje nowy.
26
+ // Renderer żyje tyle, co jeden zestaw ustawień - zmiana wejść buduje nowy.
27
27
  const renderer = createBackdropRenderer({
28
28
  effect: 'wave',
29
29
  colors: ['#5B8AF2', '#A86DF2', '#F25B9E'],
@@ -36,7 +36,7 @@ renderer.draw(context, 3.4); // klatka dla 3,4 sekundy animacji
36
36
 
37
37
  ## Dwa efekty, jedna zasada
38
38
 
39
- **signal-grid** bierze gradient z tego, **ile** kwadratów się pali w danej odległości od kotwicy —
39
+ **signal-grid** bierze gradient z tego, **ile** kwadratów się pali w danej odległości od kotwicy -
40
40
  nie przyciemnia gotowej, równomiernej siatki. **wave** opada od linii środkowej krzywą Gaussa,
41
41
  więc w całym kadrze nie ma ani jednej twardej krawędzi; to właśnie odróżnia prąd światła od paska.
42
42
 
@@ -47,30 +47,30 @@ rozmiaru okna zostawia obraz rozpoznawalnym zamiast tasować go od nowa.
47
47
 
48
48
  Rampa wstęgi jest zamknięta w pętlę i mieszana po biegunowej postaci OKLab. Interpolacja sRGB
49
49
  miesza wartości po gammie i wychodzi błotem; nawet prostokątny OKLab przecina oś achromatyczną dla
50
- przeciwnych odcieni, więc w połowie drogi z niebieskiego w żółty zostaje szarość — dokładnie tam,
50
+ przeciwnych odcieni, więc w połowie drogi z niebieskiego w żółty zostaje szarość - dokładnie tam,
51
51
  gdzie prąd świeci najmocniej.
52
52
 
53
53
  ## Wstęga liczy się w małym buforze
54
54
 
55
55
  Efekt nie ma detalu, tylko miękkość. Liczymy go więc w buforze o dłuższym boku 160 px i skalujemy
56
- w górę — rozmycie robi za darmo interpolacja przeglądarki. Kilka tysięcy pikseli na klatkę
56
+ w górę - rozmycie robi za darmo interpolacja przeglądarki. Kilka tysięcy pikseli na klatkę
57
57
  obsługuje kadr dowolnej wielkości.
58
58
 
59
59
  ## API
60
60
 
61
- - **Renderery** — `createBackdropRenderer`, `createSignalGridRenderer`, `createWaveRenderer`,
61
+ - **Renderery** - `createBackdropRenderer`, `createSignalGridRenderer`, `createWaveRenderer`,
62
62
  `resolveBackdropColors`, typy `KptBackdropRenderer`, `KptBackdropRenderOptions`,
63
63
  `KptBackdropColors`
64
- - **Siatka** — `buildSignalGrid`, `signalGridDensity`, `signalGridAlpha`, typy
64
+ - **Siatka** - `buildSignalGrid`, `signalGridDensity`, `signalGridAlpha`, typy
65
65
  `KptSignalGridOptions`, `KptSignalGridFrame`, `KptSignalGridCell`
66
- - **Wstęga** — `resolveWave`, `waveIntensity`, `waveRamp`, `waveBuffer`, typy `KptWaveOptions`,
66
+ - **Wstęga** - `resolveWave`, `waveIntensity`, `waveRamp`, `waveBuffer`, typy `KptWaveOptions`,
67
67
  `KptWaveSettings`, `KptWaveBuffer`, `KptWaveHarmonic`
68
- - **Barwy** (re-eksport z `@konce-pt/color`) — `mixOklch`, `shiftHue`, `readCssColor`,
68
+ - **Barwy** (re-eksport z `@konce-pt/color`) - `mixOklch`, `shiftHue`, `readCssColor`,
69
69
  `parseHexColor`, `toHexColor`, `srgbToOklab`, `oklabToSrgb`, `adaptLightness`, `adaptToSurface`,
70
70
  `relativeLuminance`, `prefersDarkContent`, typy `KptRgb`, `KptOklab`
71
- - **Losowanie** — `kptHash01`
72
- - **Stałe** — `KPT_SIGNAL_GRID_*`, `KPT_WAVE_*`, `KPT_BACKDROP_MAX_DPR`, `KPT_BACKDROP_MAX_STEP`
73
- - **Model** — typy `KptBackdropAnchor`, `KptBackdropEffect`
71
+ - **Losowanie** - `kptHash01`
72
+ - **Stałe** - `KPT_SIGNAL_GRID_*`, `KPT_WAVE_*`, `KPT_BACKDROP_MAX_DPR`, `KPT_BACKDROP_MAX_STEP`
73
+ - **Model** - typy `KptBackdropAnchor`, `KptBackdropEffect`
74
74
 
75
75
  Pełny opis: [`llms.txt`](https://ui.konce.pt/llms/backdrop/llms.txt) (EN)
76
76
  i [`llms-pl.txt`](https://ui.konce.pt/llms/backdrop/llms-pl.txt) (PL).
package/dist/hash.d.ts CHANGED
@@ -1,12 +1,12 @@
1
1
  /**
2
- * Deterministyczna liczba 0–1 z pary współrzędnych i ziarna.
2
+ * Deterministyczna liczba 0-1 z pary współrzędnych i ziarna.
3
3
  *
4
- * Siatka nie może trzymać stanu per komórka między klatkami — przy zmianie rozmiaru komórki
4
+ * Siatka nie może trzymać stanu per komórka między klatkami - przy zmianie rozmiaru komórki
5
5
  * wędrują, a tablica `Math.random()` rozsypałaby cały obraz. Zamiast tego każda komórka wylicza
6
6
  * swoje losowania z własnej pozycji: ta sama kolumna i wiersz zawsze dają ten sam wynik, więc
7
7
  * po zmianie rozmiaru układ pozostaje sobą, a nie mruga od nowa.
8
8
  *
9
- * Miks jest wariantem lawiny z `Math.imul` — tanio i z porządnym rozrzutem na sąsiednich
9
+ * Miks jest wariantem lawiny z `Math.imul` - tanio i z porządnym rozrzutem na sąsiednich
10
10
  * współrzędnych, gdzie zwykłe mnożenie zostawiałoby widoczne pasy.
11
11
  */
12
12
  export declare function kptHash01(x: number, y: number, seed?: number): number;
package/dist/hash.js CHANGED
@@ -1,12 +1,12 @@
1
1
  /**
2
- * Deterministyczna liczba 0–1 z pary współrzędnych i ziarna.
2
+ * Deterministyczna liczba 0-1 z pary współrzędnych i ziarna.
3
3
  *
4
- * Siatka nie może trzymać stanu per komórka między klatkami — przy zmianie rozmiaru komórki
4
+ * Siatka nie może trzymać stanu per komórka między klatkami - przy zmianie rozmiaru komórki
5
5
  * wędrują, a tablica `Math.random()` rozsypałaby cały obraz. Zamiast tego każda komórka wylicza
6
6
  * swoje losowania z własnej pozycji: ta sama kolumna i wiersz zawsze dają ten sam wynik, więc
7
7
  * po zmianie rozmiaru układ pozostaje sobą, a nie mruga od nowa.
8
8
  *
9
- * Miks jest wariantem lawiny z `Math.imul` — tanio i z porządnym rozrzutem na sąsiednich
9
+ * Miks jest wariantem lawiny z `Math.imul` - tanio i z porządnym rozrzutem na sąsiednich
10
10
  * współrzędnych, gdzie zwykłe mnożenie zostawiałoby widoczne pasy.
11
11
  */
12
12
  export function kptHash01(x, y, seed = 0) {
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Renderery efektów tła.
3
3
  *
4
- * Rysowanie nie potrzebuje frameworka — potrzebuje `CanvasRenderingContext2D`. Dzięki temu
4
+ * Rysowanie nie potrzebuje frameworka - potrzebuje `CanvasRenderingContext2D`. Dzięki temu
5
5
  * komponent w Angularze i w Reakcie zostaje samym cyklem życia (rAF, obserwatory rozmiaru,
6
6
  * widoczności i motywu) wokół tego samego renderera, zamiast dwa razy powtarzać pętlę rysowania.
7
7
  *
@@ -12,13 +12,13 @@ import type { KptRgb } from '@konce-pt/color';
12
12
  import type { KptBackdropAnchor, KptBackdropEffect } from './types.ts';
13
13
  /** Gęstość pikseli powyżej dwóch nic nie wnosi przy tych efektach, a kosztuje kwadratowo. */
14
14
  export declare const KPT_BACKDROP_MAX_DPR = 2;
15
- /** Górna granica kroku czasu (ms) — karta wróciwszy z tła nie ma przewijać animacji do przodu. */
15
+ /** Górna granica kroku czasu (ms) - karta wróciwszy z tła nie ma przewijać animacji do przodu. */
16
16
  export declare const KPT_BACKDROP_MAX_STEP = 100;
17
17
  /** O tyle stopni rozchodzą się domyślne barwy wstęgi względem koloru wiodącego. */
18
18
  export declare const KPT_BACKDROP_RAMP_SPREAD = 28;
19
19
  /**
20
- * Renderer jednego efektu. Żyje tyle, co zestaw ustawień — zmiana wejść buduje nowy,
21
- * zamiast doklejać do istniejącego ścieżki „co się zmieniło".
20
+ * Renderer jednego efektu. Żyje tyle, co zestaw ustawień - zmiana wejść buduje nowy,
21
+ * zamiast doklejać do istniejącego ścieżki "co się zmieniło".
22
22
  */
23
23
  export interface KptBackdropRenderer {
24
24
  /** Nowy rozmiar obszaru w pikselach CSS. */
@@ -28,7 +28,7 @@ export interface KptBackdropRenderer {
28
28
  /** Zwalnia bufory. Po tym renderer już nie rysuje. */
29
29
  dispose(): void;
30
30
  }
31
- /** Ustawienia renderera — płaskie, tak jak wejścia komponentu. */
31
+ /** Ustawienia renderera - płaskie, tak jak wejścia komponentu. */
32
32
  export interface KptBackdropRenderOptions {
33
33
  effect?: KptBackdropEffect;
34
34
  /** signal-grid: kolor kwadratów, dowolny zapis CSS. */
@@ -50,11 +50,11 @@ export interface KptBackdropRenderOptions {
50
50
  }
51
51
  /** Kolory gotowe do podania rendererowi. */
52
52
  export interface KptBackdropColors {
53
- /** Kolor wiodący — dowolny zapis CSS, tak jak przyszedł. */
53
+ /** Kolor wiodący - dowolny zapis CSS, tak jak przyszedł. */
54
54
  color: string;
55
55
  /** Rampa wstęgi w zapisie heksadecymalnym. */
56
56
  colors: readonly string[];
57
- /** Wpisy `colors`, których przeglądarka nie uznała za kolor — do ostrzeżenia w buildzie dev. */
57
+ /** Wpisy `colors`, których przeglądarka nie uznała za kolor - do ostrzeżenia w buildzie dev. */
58
58
  invalid: readonly string[];
59
59
  }
60
60
  /**
@@ -64,37 +64,37 @@ export interface KptBackdropColors {
64
64
  *
65
65
  * `scope` musi być **potomkiem** hosta. `observeBackdropTheme` ogląda `style` na hoście i każdym
66
66
  * jego przodku, więc sonda zapisana na hoście obudziłaby nasłuch, ten sięgnąłby po kolor na nowo,
67
- * znów zapisał sondę — i pętla nie miałaby końca. Potomek jest poza zasięgiem nasłuchu.
67
+ * znów zapisał sondę - i pętla nie miałaby końca. Potomek jest poza zasięgiem nasłuchu.
68
68
  *
69
69
  * Bramka na `var(` nie jest kosmetyczna: bez niej każdy literał kosztowałby zapis stylu
70
70
  * i wymuszone przeliczenie kaskady, a nie ma w nim czego rozwiązywać.
71
71
  *
72
- * Odwołanie do nieistniejącej zmiennej daje pusty napis — to sygnał „nie dało się", który
72
+ * Odwołanie do nieistniejącej zmiennej daje pusty napis - to sygnał "nie dało się", który
73
73
  * wywołujący czyta jako brak wartości.
74
74
  */
75
75
  export declare function resolveCssValue(scope: HTMLElement, value: string): string;
76
76
  /**
77
77
  * Sam kolor wiodący: wejście komponentu, a bez niego token odczytany z wyliczonego stylu.
78
78
  *
79
- * Wydzielone z `resolveBackdropColors`, bo służy też za tani strażnik przy zmianie motywu —
80
- * `getComputedStyle` bez sondy 1×1 i bez arytmetyki barw.
79
+ * Wydzielone z `resolveBackdropColors`, bo służy też za tani strażnik przy zmianie motywu -
80
+ * `getComputedStyle` bez sondy 1x1 i bez arytmetyki barw.
81
81
  *
82
82
  * Wejście przechodzi przez `resolveCssValue`, więc `var(--kpt-color-primary)` działa i zmienia się
83
83
  * razem z motywem, a literał zostaje literałem. Zapis odwołujący się do zmiennej, której nie ma,
84
- * schodzi do tokenu — tego chciałby autor literówki w nazwie.
84
+ * schodzi do tokenu - tego chciałby autor literówki w nazwie.
85
85
  */
86
86
  export declare function readBackdropLead(scope: HTMLElement, color: string): string;
87
- /** Powierzchnia bieżącego motywu — punkt odniesienia adaptacji. */
87
+ /** Powierzchnia bieżącego motywu - punkt odniesienia adaptacji. */
88
88
  export declare function readBackdropSurface(scope: HTMLElement): KptRgb | null;
89
89
  /**
90
90
  * Barwa przeniesiona na powierzchnię bieżącego motywu. Wartość, która nie podlega adaptacji albo
91
- * której nie da się odczytać, wraca bez zmian — adaptacja nigdy nie gubi tego, co podano.
91
+ * której nie da się odczytać, wraca bez zmian - adaptacja nigdy nie gubi tego, co podano.
92
92
  */
93
93
  export declare function adaptBackdropValue(value: string, surface: KptRgb | null): string;
94
94
  /** Czym sekcja pisze po swoim tle. */
95
95
  export interface KptBackdropInk {
96
96
  /**
97
- * Jasność tła sekcji: `light` znaczy jasne tło i ciemną treść. Puste znaczy „sekcja nie ma
97
+ * Jasność tła sekcji: `light` znaczy jasne tło i ciemną treść. Puste znaczy "sekcja nie ma
98
98
  * własnego tła" i wtedy nie ma czego ogłaszać.
99
99
  */
100
100
  tone: '' | 'light' | 'dark';
@@ -105,7 +105,7 @@ export interface KptBackdropInk {
105
105
  * Ton i kolor treści dobrane do tła, które sekcja naprawdę maluje.
106
106
  *
107
107
  * Host ustawia `color` tokenem powierzchni strony, ale sekcja z własnym `background` przestaje być
108
- * tą powierzchnią — i wtedy token opisuje sąsiada, nie to, na czym treść leży. Bez tego rachunku
108
+ * tą powierzchnią - i wtedy token opisuje sąsiada, nie to, na czym treść leży. Bez tego rachunku
109
109
  * ciemne tło w motywie jasnym daje czarny napis na czarnym.
110
110
  *
111
111
  * Ton wychodzi też na zewnątrz atrybutem, bo o kolor treści dopomina się nie tylko sam napis:
@@ -116,7 +116,7 @@ export declare function readBackdropInk(scope: HTMLElement, background: string):
116
116
  /**
117
117
  * Nasłuch na wszystkim, co może przestawić tokeny pod hostem. Zwraca funkcję odpinającą.
118
118
  *
119
- * Motyw bywa zakresowy — `[data-theme="dark"]` nie jest przywiązany do `:root`, więc tokeny
119
+ * Motyw bywa zakresowy - `[data-theme="dark"]` nie jest przywiązany do `:root`, więc tokeny
120
120
  * przestawia dowolny przodek. Łańcuch od hosta w górę jest krótki i znany, więc obserwujemy go
121
121
  * w całości, zamiast puszczać `subtree` na dokumencie, gdzie trafieniem byłaby każda zmiana klasy
122
122
  * w aplikacji. Pętla kończy się na `<html>`, bo rodzicem `<html>` jest dokument, nie element.
@@ -124,7 +124,7 @@ export declare function readBackdropInk(scope: HTMLElement, background: string):
124
124
  * Do tego zapytanie o preferencję systemu: aplikacja może trzymać ciemne tokeny w media query
125
125
  * zamiast w atrybucie i wtedy nie zmienia się nic, co da się zaobserwować w DOM.
126
126
  *
127
- * Łańcuch przodków jest brany w chwili zapisu — przeniesienie hosta w inne miejsce drzewa wymaga
127
+ * Łańcuch przodków jest brany w chwili zapisu - przeniesienie hosta w inne miejsce drzewa wymaga
128
128
  * ponownego zapisu. Komponent takiego przypadku nie obsługuje.
129
129
  *
130
130
  * Nasłuch trafia też w zmiany niezwiązane z barwą (klasa nakładki na `<html>`, dowolne nadpisanie
@@ -135,26 +135,26 @@ export declare function observeBackdropTheme(host: HTMLElement, onChange: () =>
135
135
  /**
136
136
  * Zamienia wejścia koloru na wartości, które rozumie renderer.
137
137
  *
138
- * Canvas nie rozwija `var()`, więc token trzeba odczytać z wyliczonego stylu elementu — komponent
138
+ * Canvas nie rozwija `var()`, więc token trzeba odczytać z wyliczonego stylu elementu - komponent
139
139
  * jest jedynym miejscem, które wie, z którego. Pusta rampa bierze kolor wiodący i dwie barwy
140
140
  * wyprowadzone z niego obrotem odcienia: paleta biblioteki jest neutralna, więc sięganie po tokeny
141
141
  * statusowe (`info`, `success`) byłoby użyciem semantyki do dekoracji.
142
142
  *
143
- * `adaptive` przenosi barwy wpisane na sztywno na powierzchnię bieżącego motywu — czerń wpisana
143
+ * `adaptive` przenosi barwy wpisane na sztywno na powierzchnię bieżącego motywu - czerń wpisana
144
144
  * na białe tło staje się bielą, gdy tło jest ciemne. Dotyczy wyłącznie literałów: puste wejście
145
145
  * bierze token, a zapis z `var()` sam sięga po token i jedno i drugie już idzie za motywem.
146
146
  *
147
147
  * Rampa podana wprost przechodzi tą samą drogą co domyślna: każdy wpis najpierw rozwiązujemy
148
148
  * względem drzewa (`resolveCssValue`), a potem pytamy przeglądarkę o jego znaczenie. Działa więc
149
- * i `oklch()`, i `color-mix()`, i nazwa własna, i odwołanie do tokenu — a `color-mix()` z tokenem
149
+ * i `oklch()`, i `color-mix()`, i nazwa własna, i odwołanie do tokenu - a `color-mix()` z tokenem
150
150
  * w środku daje rampę, która sama idzie za motywem. Dalej, do renderera, trafia już sam hex.
151
- * Wpisy, których przeglądarka nie przyjęła, wracają w `invalid` — rdzeń nie ma własnego trybu dev,
151
+ * Wpisy, których przeglądarka nie przyjęła, wracają w `invalid` - rdzeń nie ma własnego trybu dev,
152
152
  * więc ostrzega dopiero port. Gdy nie przeszedł żaden, schodzimy do rampy domyślnej: pusty kadr
153
153
  * nie powiedziałby nikomu nic.
154
154
  *
155
- * `scope` musi być potomkiem hosta — powód przy `resolveCssValue`.
155
+ * `scope` musi być potomkiem hosta - powód przy `resolveCssValue`.
156
156
  *
157
- * Mieszka w rdzeniu, bo oba porty muszą rozstrzygać to samo tak samo — rozjazd znaczyłby, że ta
157
+ * Mieszka w rdzeniu, bo oba porty muszą rozstrzygać to samo tak samo - rozjazd znaczyłby, że ta
158
158
  * sama sekcja ma inne barwy w Angularze niż w Reakcie.
159
159
  */
160
160
  export declare function resolveBackdropColors(scope: HTMLElement, color: string, colors: readonly string[], adaptive?: boolean): KptBackdropColors;
@@ -166,7 +166,7 @@ export declare function createSignalGridRenderer(options: KptBackdropRenderOptio
166
166
  /**
167
167
  * Jedna miękka wstęga światła z barwami przesuwającymi się wzdłuż niej.
168
168
  *
169
- * Liczymy ją w buforze o dłuższym boku `KPT_WAVE_RESOLUTION` i skalujemy w górę — miękkość
169
+ * Liczymy ją w buforze o dłuższym boku `KPT_WAVE_RESOLUTION` i skalujemy w górę - miękkość
170
170
  * bierze się z interpolacji przeglądarki, więc kilkanaście tysięcy pikseli na klatkę wystarcza
171
171
  * na dowolnie duży kadr. Rampa barw idzie przez podręczną tablicę: mieszanie po kole OKLCH raz
172
172
  * na piksel byłoby kilkoma pierwiastkami i arkusem tangensa na każdy z nich.
package/dist/renderer.js CHANGED
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Renderery efektów tła.
3
3
  *
4
- * Rysowanie nie potrzebuje frameworka — potrzebuje `CanvasRenderingContext2D`. Dzięki temu
4
+ * Rysowanie nie potrzebuje frameworka - potrzebuje `CanvasRenderingContext2D`. Dzięki temu
5
5
  * komponent w Angularze i w Reakcie zostaje samym cyklem życia (rAF, obserwatory rozmiaru,
6
6
  * widoczności i motywu) wokół tego samego renderera, zamiast dwa razy powtarzać pętlę rysowania.
7
7
  *
@@ -11,13 +11,13 @@
11
11
  import { adaptToSurface, mixOklch, parseHexColor, prefersDarkContent, readCssColor, shiftHue, toHexColor, } from '@konce-pt/color';
12
12
  import { buildSignalGrid, signalGridAlpha } from "./signal-grid.js";
13
13
  import { resolveWave, waveBuffer, waveIntensity, waveRamp } from "./wave.js";
14
- /** Poniżej tego krycia kwadrat i tak nie byłby widoczny — nie ma po co go rysować. */
14
+ /** Poniżej tego krycia kwadrat i tak nie byłby widoczny - nie ma po co go rysować. */
15
15
  const ALPHA_CUTOFF = 0.02;
16
16
  /** Ile przystanków ma podręczna tablica barw rampy. */
17
17
  const LUT_STOPS = 256;
18
18
  /** Gęstość pikseli powyżej dwóch nic nie wnosi przy tych efektach, a kosztuje kwadratowo. */
19
19
  export const KPT_BACKDROP_MAX_DPR = 2;
20
- /** Górna granica kroku czasu (ms) — karta wróciwszy z tła nie ma przewijać animacji do przodu. */
20
+ /** Górna granica kroku czasu (ms) - karta wróciwszy z tła nie ma przewijać animacji do przodu. */
21
21
  export const KPT_BACKDROP_MAX_STEP = 100;
22
22
  /** O tyle stopni rozchodzą się domyślne barwy wstęgi względem koloru wiodącego. */
23
23
  export const KPT_BACKDROP_RAMP_SPREAD = 28;
@@ -30,12 +30,12 @@ const PROBE_PROPERTY = '--_kpt-probe';
30
30
  *
31
31
  * `scope` musi być **potomkiem** hosta. `observeBackdropTheme` ogląda `style` na hoście i każdym
32
32
  * jego przodku, więc sonda zapisana na hoście obudziłaby nasłuch, ten sięgnąłby po kolor na nowo,
33
- * znów zapisał sondę — i pętla nie miałaby końca. Potomek jest poza zasięgiem nasłuchu.
33
+ * znów zapisał sondę - i pętla nie miałaby końca. Potomek jest poza zasięgiem nasłuchu.
34
34
  *
35
35
  * Bramka na `var(` nie jest kosmetyczna: bez niej każdy literał kosztowałby zapis stylu
36
36
  * i wymuszone przeliczenie kaskady, a nie ma w nim czego rozwiązywać.
37
37
  *
38
- * Odwołanie do nieistniejącej zmiennej daje pusty napis — to sygnał „nie dało się", który
38
+ * Odwołanie do nieistniejącej zmiennej daje pusty napis - to sygnał "nie dało się", który
39
39
  * wywołujący czyta jako brak wartości.
40
40
  */
41
41
  export function resolveCssValue(scope, value) {
@@ -49,12 +49,12 @@ export function resolveCssValue(scope, value) {
49
49
  /**
50
50
  * Sam kolor wiodący: wejście komponentu, a bez niego token odczytany z wyliczonego stylu.
51
51
  *
52
- * Wydzielone z `resolveBackdropColors`, bo służy też za tani strażnik przy zmianie motywu —
53
- * `getComputedStyle` bez sondy 1×1 i bez arytmetyki barw.
52
+ * Wydzielone z `resolveBackdropColors`, bo służy też za tani strażnik przy zmianie motywu -
53
+ * `getComputedStyle` bez sondy 1x1 i bez arytmetyki barw.
54
54
  *
55
55
  * Wejście przechodzi przez `resolveCssValue`, więc `var(--kpt-color-primary)` działa i zmienia się
56
56
  * razem z motywem, a literał zostaje literałem. Zapis odwołujący się do zmiennej, której nie ma,
57
- * schodzi do tokenu — tego chciałby autor literówki w nazwie.
57
+ * schodzi do tokenu - tego chciałby autor literówki w nazwie.
58
58
  */
59
59
  export function readBackdropLead(scope, color) {
60
60
  const explicit = resolveCssValue(scope, color.trim());
@@ -66,18 +66,18 @@ export function readBackdropLead(scope, color) {
66
66
  /**
67
67
  * Czy adaptacja ma tę wartość ruszać.
68
68
  *
69
- * Pusta bierze token, a zapis z `var()` sam sięga po token — jedno i drugie już idzie za motywem
69
+ * Pusta bierze token, a zapis z `var()` sam sięga po token - jedno i drugie już idzie za motywem
70
70
  * i przeliczenie odwróciłoby je drugi raz, czyli z powrotem. Adaptacja dotyczy wyłącznie tego,
71
71
  * co autor wpisał na sztywno, bo tylko to nie umie się samo ruszyć.
72
72
  */
73
73
  const adaptable = (value) => value.trim() !== '' && !value.includes('var(');
74
- /** Powierzchnia bieżącego motywu — punkt odniesienia adaptacji. */
74
+ /** Powierzchnia bieżącego motywu - punkt odniesienia adaptacji. */
75
75
  export function readBackdropSurface(scope) {
76
76
  return readCssColor(resolveCssValue(scope, 'var(--kpt-color-surface)'));
77
77
  }
78
78
  /**
79
79
  * Barwa przeniesiona na powierzchnię bieżącego motywu. Wartość, która nie podlega adaptacji albo
80
- * której nie da się odczytać, wraca bez zmian — adaptacja nigdy nie gubi tego, co podano.
80
+ * której nie da się odczytać, wraca bez zmian - adaptacja nigdy nie gubi tego, co podano.
81
81
  */
82
82
  export function adaptBackdropValue(value, surface) {
83
83
  if (!surface || !adaptable(value))
@@ -93,7 +93,7 @@ const LIGHT_CONTENT = 'var(--kpt-color-neutral-50)';
93
93
  * Ton i kolor treści dobrane do tła, które sekcja naprawdę maluje.
94
94
  *
95
95
  * Host ustawia `color` tokenem powierzchni strony, ale sekcja z własnym `background` przestaje być
96
- * tą powierzchnią — i wtedy token opisuje sąsiada, nie to, na czym treść leży. Bez tego rachunku
96
+ * tą powierzchnią - i wtedy token opisuje sąsiada, nie to, na czym treść leży. Bez tego rachunku
97
97
  * ciemne tło w motywie jasnym daje czarny napis na czarnym.
98
98
  *
99
99
  * Ton wychodzi też na zewnątrz atrybutem, bo o kolor treści dopomina się nie tylko sam napis:
@@ -115,7 +115,7 @@ const THEME_ATTRIBUTES = ['data-theme', 'class', 'style'];
115
115
  /**
116
116
  * Nasłuch na wszystkim, co może przestawić tokeny pod hostem. Zwraca funkcję odpinającą.
117
117
  *
118
- * Motyw bywa zakresowy — `[data-theme="dark"]` nie jest przywiązany do `:root`, więc tokeny
118
+ * Motyw bywa zakresowy - `[data-theme="dark"]` nie jest przywiązany do `:root`, więc tokeny
119
119
  * przestawia dowolny przodek. Łańcuch od hosta w górę jest krótki i znany, więc obserwujemy go
120
120
  * w całości, zamiast puszczać `subtree` na dokumencie, gdzie trafieniem byłaby każda zmiana klasy
121
121
  * w aplikacji. Pętla kończy się na `<html>`, bo rodzicem `<html>` jest dokument, nie element.
@@ -123,7 +123,7 @@ const THEME_ATTRIBUTES = ['data-theme', 'class', 'style'];
123
123
  * Do tego zapytanie o preferencję systemu: aplikacja może trzymać ciemne tokeny w media query
124
124
  * zamiast w atrybucie i wtedy nie zmienia się nic, co da się zaobserwować w DOM.
125
125
  *
126
- * Łańcuch przodków jest brany w chwili zapisu — przeniesienie hosta w inne miejsce drzewa wymaga
126
+ * Łańcuch przodków jest brany w chwili zapisu - przeniesienie hosta w inne miejsce drzewa wymaga
127
127
  * ponownego zapisu. Komponent takiego przypadku nie obsługuje.
128
128
  *
129
129
  * Nasłuch trafia też w zmiany niezwiązane z barwą (klasa nakładki na `<html>`, dowolne nadpisanie
@@ -147,26 +147,26 @@ export function observeBackdropTheme(host, onChange) {
147
147
  /**
148
148
  * Zamienia wejścia koloru na wartości, które rozumie renderer.
149
149
  *
150
- * Canvas nie rozwija `var()`, więc token trzeba odczytać z wyliczonego stylu elementu — komponent
150
+ * Canvas nie rozwija `var()`, więc token trzeba odczytać z wyliczonego stylu elementu - komponent
151
151
  * jest jedynym miejscem, które wie, z którego. Pusta rampa bierze kolor wiodący i dwie barwy
152
152
  * wyprowadzone z niego obrotem odcienia: paleta biblioteki jest neutralna, więc sięganie po tokeny
153
153
  * statusowe (`info`, `success`) byłoby użyciem semantyki do dekoracji.
154
154
  *
155
- * `adaptive` przenosi barwy wpisane na sztywno na powierzchnię bieżącego motywu — czerń wpisana
155
+ * `adaptive` przenosi barwy wpisane na sztywno na powierzchnię bieżącego motywu - czerń wpisana
156
156
  * na białe tło staje się bielą, gdy tło jest ciemne. Dotyczy wyłącznie literałów: puste wejście
157
157
  * bierze token, a zapis z `var()` sam sięga po token i jedno i drugie już idzie za motywem.
158
158
  *
159
159
  * Rampa podana wprost przechodzi tą samą drogą co domyślna: każdy wpis najpierw rozwiązujemy
160
160
  * względem drzewa (`resolveCssValue`), a potem pytamy przeglądarkę o jego znaczenie. Działa więc
161
- * i `oklch()`, i `color-mix()`, i nazwa własna, i odwołanie do tokenu — a `color-mix()` z tokenem
161
+ * i `oklch()`, i `color-mix()`, i nazwa własna, i odwołanie do tokenu - a `color-mix()` z tokenem
162
162
  * w środku daje rampę, która sama idzie za motywem. Dalej, do renderera, trafia już sam hex.
163
- * Wpisy, których przeglądarka nie przyjęła, wracają w `invalid` — rdzeń nie ma własnego trybu dev,
163
+ * Wpisy, których przeglądarka nie przyjęła, wracają w `invalid` - rdzeń nie ma własnego trybu dev,
164
164
  * więc ostrzega dopiero port. Gdy nie przeszedł żaden, schodzimy do rampy domyślnej: pusty kadr
165
165
  * nie powiedziałby nikomu nic.
166
166
  *
167
- * `scope` musi być potomkiem hosta — powód przy `resolveCssValue`.
167
+ * `scope` musi być potomkiem hosta - powód przy `resolveCssValue`.
168
168
  *
169
- * Mieszka w rdzeniu, bo oba porty muszą rozstrzygać to samo tak samo — rozjazd znaczyłby, że ta
169
+ * Mieszka w rdzeniu, bo oba porty muszą rozstrzygać to samo tak samo - rozjazd znaczyłby, że ta
170
170
  * sama sekcja ma inne barwy w Angularze niż w Reakcie.
171
171
  */
172
172
  export function resolveBackdropColors(scope, color, colors, adaptive = false) {
@@ -199,7 +199,7 @@ export function resolveBackdropColors(scope, color, colors, adaptive = false) {
199
199
  invalid,
200
200
  };
201
201
  }
202
- /** Renderer, który nic nie rysuje — dla środowisk bez DOM i dla pustej rampy barw. */
202
+ /** Renderer, który nic nie rysuje - dla środowisk bez DOM i dla pustej rampy barw. */
203
203
  const IDLE = {
204
204
  resize: () => undefined,
205
205
  draw: () => undefined,
@@ -251,7 +251,7 @@ export function createSignalGridRenderer(options) {
251
251
  /**
252
252
  * Jedna miękka wstęga światła z barwami przesuwającymi się wzdłuż niej.
253
253
  *
254
- * Liczymy ją w buforze o dłuższym boku `KPT_WAVE_RESOLUTION` i skalujemy w górę — miękkość
254
+ * Liczymy ją w buforze o dłuższym boku `KPT_WAVE_RESOLUTION` i skalujemy w górę - miękkość
255
255
  * bierze się z interpolacji przeglądarki, więc kilkanaście tysięcy pikseli na klatkę wystarcza
256
256
  * na dowolnie duży kadr. Rampa barw idzie przez podręczną tablicę: mieszanie po kole OKLCH raz
257
257
  * na piksel byłoby kilkoma pierwiastkami i arkusem tangensa na każdy z nich.
@@ -304,7 +304,7 @@ export function createWaveRenderer(options) {
304
304
  const data = image.data;
305
305
  let offset = 0;
306
306
  for (let row = 0; row < rows; row += 1) {
307
- // Próbkujemy środek komórki bufora, nie jej róg — inaczej obraz przesuwałby się
307
+ // Próbkujemy środek komórki bufora, nie jej róg - inaczej obraz przesuwałby się
308
308
  // o pół piksela przy każdej zmianie rozdzielczości.
309
309
  const v = (row + 0.5) / rows;
310
310
  for (let col = 0; col < cols; col += 1) {
@@ -9,16 +9,16 @@ export declare const KPT_SIGNAL_GRID_DENSITY = 0.8;
9
9
  export declare const KPT_SIGNAL_GRID_FALLOFF = 1.4;
10
10
  /** Krycie komórki w dołku migotania. */
11
11
  export declare const KPT_SIGNAL_GRID_FLOOR = 0.18;
12
- /** Radiany na sekundę przy `speed = 1` — pełny cykl komórki to wtedy około siedmiu sekund. */
12
+ /** Radiany na sekundę przy `speed = 1` - pełny cykl komórki to wtedy około siedmiu sekund. */
13
13
  export declare const KPT_SIGNAL_GRID_RATE = 0.9;
14
14
  /**
15
15
  * Rampa gęstości: udział zapalonych komórek w odległości `distance` od kotwicy (0 przy kotwicy,
16
- * 1 przy przeciwnej krawędzi). To ona robi cały efekt — gradient bierze się z tego, ile kwadratów
16
+ * 1 przy przeciwnej krawędzi). To ona robi cały efekt - gradient bierze się z tego, ile kwadratów
17
17
  * się pali, nie z przezroczystości nałożonej na równomierną siatkę.
18
18
  */
19
19
  export declare function signalGridDensity(distance: number, density: number, falloff: number): number;
20
20
  /**
21
- * Buduje siatkę pod zadany obszar. Liczy się raz — przy starcie i przy zmianie rozmiaru — bo
21
+ * Buduje siatkę pod zadany obszar. Liczy się raz - przy starcie i przy zmianie rozmiaru - bo
22
22
  * geometria i losowania komórek są w czasie stałe; w klatce zmienia się wyłącznie krycie.
23
23
  *
24
24
  * Siatka celowo wychodzi poza obszar: liczba kolumn zaokrągla się w górę, a nadmiar rozkłada się
@@ -26,7 +26,7 @@ export declare function signalGridDensity(distance: number, density: number, fal
26
26
  */
27
27
  export declare function buildSignalGrid(options: KptSignalGridOptions): KptSignalGridFrame;
28
28
  /**
29
- * Krycie komórki w chwili `time` (sekundy). Sinus przepuszczony przez wygładzenie — surowy
29
+ * Krycie komórki w chwili `time` (sekundy). Sinus przepuszczony przez wygładzenie - surowy
30
30
  * zostawiałby komórki najdłużej w połowie jasności, a migotanie ma przystawać na końcach.
31
31
  *
32
32
  * `speed` równe zeru zatrzymuje obraz, nie gasi go: każda komórka zostaje na swojej fazie,
@@ -9,22 +9,22 @@ export const KPT_SIGNAL_GRID_DENSITY = 0.8;
9
9
  export const KPT_SIGNAL_GRID_FALLOFF = 1.4;
10
10
  /** Krycie komórki w dołku migotania. */
11
11
  export const KPT_SIGNAL_GRID_FLOOR = 0.18;
12
- /** Radiany na sekundę przy `speed = 1` — pełny cykl komórki to wtedy około siedmiu sekund. */
12
+ /** Radiany na sekundę przy `speed = 1` - pełny cykl komórki to wtedy około siedmiu sekund. */
13
13
  export const KPT_SIGNAL_GRID_RATE = 0.9;
14
- /** Szczytowe krycie komórki przy przeciwnej krawędzi — tam, gdzie rampa już nic nie daje. */
14
+ /** Szczytowe krycie komórki przy przeciwnej krawędzi - tam, gdzie rampa już nic nie daje. */
15
15
  const MIN_PRESENCE = 0.35;
16
16
  const TAU = Math.PI * 2;
17
17
  const clamp01 = (value) => (value < 0 ? 0 : value > 1 ? 1 : value);
18
18
  /**
19
19
  * Rampa gęstości: udział zapalonych komórek w odległości `distance` od kotwicy (0 przy kotwicy,
20
- * 1 przy przeciwnej krawędzi). To ona robi cały efekt — gradient bierze się z tego, ile kwadratów
20
+ * 1 przy przeciwnej krawędzi). To ona robi cały efekt - gradient bierze się z tego, ile kwadratów
21
21
  * się pali, nie z przezroczystości nałożonej na równomierną siatkę.
22
22
  */
23
23
  export function signalGridDensity(distance, density, falloff) {
24
24
  return density * Math.pow(1 - clamp01(distance), Math.max(0, falloff));
25
25
  }
26
26
  /**
27
- * Buduje siatkę pod zadany obszar. Liczy się raz — przy starcie i przy zmianie rozmiaru — bo
27
+ * Buduje siatkę pod zadany obszar. Liczy się raz - przy starcie i przy zmianie rozmiaru - bo
28
28
  * geometria i losowania komórek są w czasie stałe; w klatce zmienia się wyłącznie krycie.
29
29
  *
30
30
  * Siatka celowo wychodzi poza obszar: liczba kolumn zaokrągla się w górę, a nadmiar rozkłada się
@@ -64,7 +64,7 @@ export function buildSignalGrid(options) {
64
64
  size: cell,
65
65
  presence,
66
66
  phase: kptHash01(col, row, seed + 101) * TAU,
67
- // Tempo rozstrzelone w przedziale 0,45–1,55: przy jednym tempie cała siatka
67
+ // Tempo rozstrzelone w przedziale 0,45-1,55: przy jednym tempie cała siatka
68
68
  // pulsowałaby zgodnie i zamiast migotania wyszedłby oddech.
69
69
  rate: 0.45 + kptHash01(col, row, seed + 211) * 1.1,
70
70
  });
@@ -73,7 +73,7 @@ export function buildSignalGrid(options) {
73
73
  return { cols, rows, cell, gap, cells };
74
74
  }
75
75
  /**
76
- * Krycie komórki w chwili `time` (sekundy). Sinus przepuszczony przez wygładzenie — surowy
76
+ * Krycie komórki w chwili `time` (sekundy). Sinus przepuszczony przez wygładzenie - surowy
77
77
  * zostawiałby komórki najdłużej w połowie jasności, a migotanie ma przystawać na końcach.
78
78
  *
79
79
  * `speed` równe zeru zatrzymuje obraz, nie gasi go: każda komórka zostaje na swojej fazie,
package/dist/types.d.ts CHANGED
@@ -14,11 +14,11 @@ export interface KptSignalGridOptions {
14
14
  gap?: number;
15
15
  /** Krawędź, przy której siatka jest najgęstsza. */
16
16
  anchor?: KptBackdropAnchor;
17
- /** Udział zapalonych komórek przy kotwicy, 0–1. */
17
+ /** Udział zapalonych komórek przy kotwicy, 0-1. */
18
18
  density?: number;
19
19
  /** Jak szybko gęstość spada ku przeciwnej krawędzi; >1 gasi gwałtowniej. */
20
20
  falloff?: number;
21
- /** Ziarno losowania — ta sama wartość daje ten sam układ przy każdym uruchomieniu. */
21
+ /** Ziarno losowania - ta sama wartość daje ten sam układ przy każdym uruchomieniu. */
22
22
  seed?: number;
23
23
  }
24
24
  /** Pojedynczy kwadrat. Geometria i losowania liczą się raz, przy zmianie rozmiaru. */
@@ -28,11 +28,11 @@ export interface KptSignalGridCell {
28
28
  y: number;
29
29
  /** Bok kwadratu (px). */
30
30
  size: number;
31
- /** Szczytowa krycie komórki, 0–1 — spada wraz z gęstością ku przeciwnej krawędzi. */
31
+ /** Szczytowa krycie komórki, 0-1 - spada wraz z gęstością ku przeciwnej krawędzi. */
32
32
  presence: number;
33
33
  /** Przesunięcie fazy migotania (radiany). */
34
34
  phase: number;
35
- /** Mnożnik tempa migotania — bez niego cała siatka pulsowałaby zgodnie. */
35
+ /** Mnożnik tempa migotania - bez niego cała siatka pulsowałaby zgodnie. */
36
36
  rate: number;
37
37
  }
38
38
  /** Gotowa siatka: wymiary w komórkach i lista kwadratów do narysowania. */
@@ -61,7 +61,7 @@ export interface KptWaveOptions {
61
61
  spread?: number;
62
62
  /** Ile rampy barw przesuwa się na sekundę. */
63
63
  drift?: number;
64
- /** Ziarno losowania — ta sama wartość daje ten sam przebieg falowania. */
64
+ /** Ziarno losowania - ta sama wartość daje ten sam przebieg falowania. */
65
65
  seed?: number;
66
66
  }
67
67
  /** Jedna składowa linii środkowej wstęgi. */
@@ -73,7 +73,7 @@ export interface KptWaveHarmonic {
73
73
  }
74
74
  /**
75
75
  * Ustawienia rozłożone na wartości gotowe do odczytu w pętli po pikselach.
76
- * Powstają raz, przy zmianie wejść albo rozmiaru — nie na każdą klatkę.
76
+ * Powstają raz, przy zmianie wejść albo rozmiaru - nie na każdą klatkę.
77
77
  */
78
78
  export interface KptWaveSettings {
79
79
  /** Proporcja kadru; bez niej obrót skośnie ściskałby wstęgę. */
@@ -89,8 +89,8 @@ export interface KptWaveSettings {
89
89
  }
90
90
  /** Ustawienia krycia w czasie. */
91
91
  export interface KptSignalGridAlphaOptions {
92
- /** Mnożnik tempa — 1 to domyślne tempo `KPT_SIGNAL_GRID_RATE`. */
92
+ /** Mnożnik tempa - 1 to domyślne tempo `KPT_SIGNAL_GRID_RATE`. */
93
93
  speed?: number;
94
- /** Krycie komórki w dołku migotania, 0–1. Zero gasi ją do końca. */
94
+ /** Krycie komórki w dołku migotania, 0-1. Zero gasi ją do końca. */
95
95
  floor?: number;
96
96
  }
package/dist/wave.d.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  import type { KptWaveOptions, KptWaveSettings } from './types.ts';
2
2
  /** Dłuższy bok bufora, w którym liczy się efekt (px). */
3
3
  export declare const KPT_WAVE_RESOLUTION = 160;
4
- /** Najmniejsza liczba próbek na bok bufora — chyba że sam obszar jest mniejszy. */
4
+ /** Najmniejsza liczba próbek na bok bufora - chyba że sam obszar jest mniejszy. */
5
5
  export declare const KPT_WAVE_MIN_SIDE = 72;
6
6
  /** Szerokość wstęgi jako ułamek wysokości kadru. */
7
7
  export declare const KPT_WAVE_BAND = 0.34;
@@ -23,36 +23,36 @@ export interface KptWaveBuffer {
23
23
  /**
24
24
  * Wymiary bufora pod zadany obszar.
25
25
  *
26
- * Wstęga nie ma detalu — jest samą miękkością — więc liczenie jej w pełnej rozdzielczości canvasu
26
+ * Wstęga nie ma detalu - jest samą miękkością - więc liczenie jej w pełnej rozdzielczości canvasu
27
27
  * byłoby płaceniem za piksele, które i tak zostaną rozmyte. Bufor o dłuższym boku
28
28
  * `KPT_WAVE_RESOLUTION` daje kilkanaście tysięcy pikseli na klatkę, a rozmycie robi za darmo
29
29
  * interpolacja przeglądarki przy skalowaniu go w górę.
30
30
  *
31
31
  * Krótszy bok ma osobną podłogę `KPT_WAVE_MIN_SIDE`. W szerokim kadrze proporcjonalne skalowanie
32
32
  * zostawiłoby kilkadziesiąt wierszy, a po obróceniu wstęgi o kąt bliski prostemu krzywa biegłaby
33
- * właśnie wzdłuż tej osi i zaczynała się łamać. Bufor nie musi trzymać proporcji kadru —
33
+ * właśnie wzdłuż tej osi i zaczynała się łamać. Bufor nie musi trzymać proporcji kadru -
34
34
  * próbkowanie chodzi po współrzędnych znormalizowanych, a geometrię niesie `aspect` w ustawieniach.
35
35
  */
36
36
  export declare function waveBuffer(width: number, height: number, resolution?: number): KptWaveBuffer;
37
37
  /**
38
38
  * Rozkłada ustawienia na wartości, które w pętli po pikselach są już tylko odczytywane.
39
39
  *
40
- * Domyślne wartości, sinus i cosinus kąta oraz harmoniczne liczą się raz — przy zmianie wejść
41
- * albo rozmiaru — bo inaczej szłyby kilkanaście tysięcy razy na klatkę.
40
+ * Domyślne wartości, sinus i cosinus kąta oraz harmoniczne liczą się raz - przy zmianie wejść
41
+ * albo rozmiaru - bo inaczej szłyby kilkanaście tysięcy razy na klatkę.
42
42
  */
43
43
  export declare function resolveWave(options: KptWaveOptions): KptWaveSettings;
44
44
  /**
45
45
  * Jasność wstęgi w punkcie `(u, v)` znormalizowanego kadru, w chwili `time` (sekundy).
46
46
  *
47
- * Linia środkowa to suma harmonicznych o niewspółmiernych częstotliwościach — stąd prąd faluje
47
+ * Linia środkowa to suma harmonicznych o niewspółmiernych częstotliwościach - stąd prąd faluje
48
48
  * bez powtarzalnego wzoru. Od niej jasność opada krzywą Gaussa, więc w całym kadrze nie ma ani
49
49
  * jednej twardej krawędzi; to właśnie odróżnia prąd światła od paska.
50
50
  */
51
51
  export declare function waveIntensity(u: number, v: number, time: number, settings: KptWaveSettings): number;
52
52
  /**
53
- * Miejsce na rampie barw (0–1) dla punktu `(u, v)` w chwili `time`.
53
+ * Miejsce na rampie barw (0-1) dla punktu `(u, v)` w chwili `time`.
54
54
  *
55
- * Barwy przesuwają się wzdłuż wstęgi, nie w poprzek — dlatego liczy się tylko współrzędna `s`.
56
- * Wynik zawsze zawija się do 0–1, więc rosnący czas nie wyprowadza go poza rampę.
55
+ * Barwy przesuwają się wzdłuż wstęgi, nie w poprzek - dlatego liczy się tylko współrzędna `s`.
56
+ * Wynik zawsze zawija się do 0-1, więc rosnący czas nie wyprowadza go poza rampę.
57
57
  */
58
58
  export declare function waveRamp(u: number, v: number, time: number, settings: KptWaveSettings): number;
package/dist/wave.js CHANGED
@@ -1,7 +1,7 @@
1
1
  import { kptHash01 } from "./hash.js";
2
2
  /** Dłuższy bok bufora, w którym liczy się efekt (px). */
3
3
  export const KPT_WAVE_RESOLUTION = 160;
4
- /** Najmniejsza liczba próbek na bok bufora — chyba że sam obszar jest mniejszy. */
4
+ /** Najmniejsza liczba próbek na bok bufora - chyba że sam obszar jest mniejszy. */
5
5
  export const KPT_WAVE_MIN_SIDE = 72;
6
6
  /** Szerokość wstęgi jako ułamek wysokości kadru. */
7
7
  export const KPT_WAVE_BAND = 0.34;
@@ -22,14 +22,14 @@ const DEG = TAU / 360;
22
22
  /**
23
23
  * Wymiary bufora pod zadany obszar.
24
24
  *
25
- * Wstęga nie ma detalu — jest samą miękkością — więc liczenie jej w pełnej rozdzielczości canvasu
25
+ * Wstęga nie ma detalu - jest samą miękkością - więc liczenie jej w pełnej rozdzielczości canvasu
26
26
  * byłoby płaceniem za piksele, które i tak zostaną rozmyte. Bufor o dłuższym boku
27
27
  * `KPT_WAVE_RESOLUTION` daje kilkanaście tysięcy pikseli na klatkę, a rozmycie robi za darmo
28
28
  * interpolacja przeglądarki przy skalowaniu go w górę.
29
29
  *
30
30
  * Krótszy bok ma osobną podłogę `KPT_WAVE_MIN_SIDE`. W szerokim kadrze proporcjonalne skalowanie
31
31
  * zostawiłoby kilkadziesiąt wierszy, a po obróceniu wstęgi o kąt bliski prostemu krzywa biegłaby
32
- * właśnie wzdłuż tej osi i zaczynała się łamać. Bufor nie musi trzymać proporcji kadru —
32
+ * właśnie wzdłuż tej osi i zaczynała się łamać. Bufor nie musi trzymać proporcji kadru -
33
33
  * próbkowanie chodzi po współrzędnych znormalizowanych, a geometrię niesie `aspect` w ustawieniach.
34
34
  */
35
35
  export function waveBuffer(width, height, resolution = KPT_WAVE_RESOLUTION) {
@@ -43,8 +43,8 @@ export function waveBuffer(width, height, resolution = KPT_WAVE_RESOLUTION) {
43
43
  /**
44
44
  * Rozkłada ustawienia na wartości, które w pętli po pikselach są już tylko odczytywane.
45
45
  *
46
- * Domyślne wartości, sinus i cosinus kąta oraz harmoniczne liczą się raz — przy zmianie wejść
47
- * albo rozmiaru — bo inaczej szłyby kilkanaście tysięcy razy na klatkę.
46
+ * Domyślne wartości, sinus i cosinus kąta oraz harmoniczne liczą się raz - przy zmianie wejść
47
+ * albo rozmiaru - bo inaczej szłyby kilkanaście tysięcy razy na klatkę.
48
48
  */
49
49
  export function resolveWave(options) {
50
50
  const width = Math.max(0, options.width);
@@ -80,7 +80,7 @@ const across = (u, v, settings) => -(u - 0.5) * settings.aspect * settings.sin +
80
80
  /**
81
81
  * Jasność wstęgi w punkcie `(u, v)` znormalizowanego kadru, w chwili `time` (sekundy).
82
82
  *
83
- * Linia środkowa to suma harmonicznych o niewspółmiernych częstotliwościach — stąd prąd faluje
83
+ * Linia środkowa to suma harmonicznych o niewspółmiernych częstotliwościach - stąd prąd faluje
84
84
  * bez powtarzalnego wzoru. Od niej jasność opada krzywą Gaussa, więc w całym kadrze nie ma ani
85
85
  * jednej twardej krawędzi; to właśnie odróżnia prąd światła od paska.
86
86
  */
@@ -96,10 +96,10 @@ export function waveIntensity(u, v, time, settings) {
96
96
  return Math.exp(-(distance ** settings.softness));
97
97
  }
98
98
  /**
99
- * Miejsce na rampie barw (0–1) dla punktu `(u, v)` w chwili `time`.
99
+ * Miejsce na rampie barw (0-1) dla punktu `(u, v)` w chwili `time`.
100
100
  *
101
- * Barwy przesuwają się wzdłuż wstęgi, nie w poprzek — dlatego liczy się tylko współrzędna `s`.
102
- * Wynik zawsze zawija się do 0–1, więc rosnący czas nie wyprowadza go poza rampę.
101
+ * Barwy przesuwają się wzdłuż wstęgi, nie w poprzek - dlatego liczy się tylko współrzędna `s`.
102
+ * Wynik zawsze zawija się do 0-1, więc rosnący czas nie wyprowadza go poza rampę.
103
103
  */
104
104
  export function waveRamp(u, v, time, settings) {
105
105
  const position = along(u, v, settings) * settings.spread + time * settings.drift;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@konce-pt/backdrop",
3
- "version": "0.12.0",
4
- "description": "Animated backdrop core for Koncept UI — canvas renderers plus the maths behind two effects: a density-ramped grid of squares and a flowing current of light with an OKLCH colour ramp. Framework-free TypeScript; the colour maths lives in @konce-pt/color.",
3
+ "version": "0.14.0",
4
+ "description": "Animated backdrop core for Koncept UI - canvas renderers plus the maths behind two effects: a density-ramped grid of squares and a flowing current of light with an OKLCH colour ramp. Framework-free TypeScript; the colour maths lives in @konce-pt/color.",
5
5
  "license": "MIT",
6
6
  "author": "konce.pt",
7
7
  "homepage": "https://ui.konce.pt/",
@@ -37,7 +37,7 @@
37
37
  }
38
38
  },
39
39
  "dependencies": {
40
- "@konce-pt/color": "0.12.0"
40
+ "@konce-pt/color": "0.14.0"
41
41
  },
42
42
  "devDependencies": {
43
43
  "typescript": "~6.0.3"