@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 +13 -13
- package/dist/hash.d.ts +3 -3
- package/dist/hash.js +3 -3
- package/dist/renderer.d.ts +25 -25
- package/dist/renderer.js +23 -23
- package/dist/signal-grid.d.ts +4 -4
- package/dist/signal-grid.js +6 -6
- package/dist/types.d.ts +8 -8
- package/dist/wave.d.ts +9 -9
- package/dist/wave.js +9 -9
- package/package.json +3 -3
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
|
|
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ę
|
|
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ń
|
|
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ść
|
|
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ę
|
|
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**
|
|
61
|
+
- **Renderery** - `createBackdropRenderer`, `createSignalGridRenderer`, `createWaveRenderer`,
|
|
62
62
|
`resolveBackdropColors`, typy `KptBackdropRenderer`, `KptBackdropRenderOptions`,
|
|
63
63
|
`KptBackdropColors`
|
|
64
|
-
- **Siatka**
|
|
64
|
+
- **Siatka** - `buildSignalGrid`, `signalGridDensity`, `signalGridAlpha`, typy
|
|
65
65
|
`KptSignalGridOptions`, `KptSignalGridFrame`, `KptSignalGridCell`
|
|
66
|
-
- **Wstęga**
|
|
66
|
+
- **Wstęga** - `resolveWave`, `waveIntensity`, `waveRamp`, `waveBuffer`, typy `KptWaveOptions`,
|
|
67
67
|
`KptWaveSettings`, `KptWaveBuffer`, `KptWaveHarmonic`
|
|
68
|
-
- **Barwy** (re-eksport z `@konce-pt/color`)
|
|
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**
|
|
72
|
-
- **Stałe**
|
|
73
|
-
- **Model**
|
|
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
|
|
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
|
|
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`
|
|
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
|
|
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
|
|
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`
|
|
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) {
|
package/dist/renderer.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Renderery efektów tła.
|
|
3
3
|
*
|
|
4
|
-
* Rysowanie nie potrzebuje frameworka
|
|
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)
|
|
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ń
|
|
21
|
-
* zamiast doklejać do istniejącego ścieżki
|
|
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
|
|
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
|
|
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
|
|
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ę
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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ą
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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`
|
|
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
|
|
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
|
|
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ę
|
|
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
|
|
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
|
|
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)
|
|
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ę
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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ą
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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`
|
|
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
|
|
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
|
|
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
|
|
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ę
|
|
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
|
|
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) {
|
package/dist/signal-grid.d.ts
CHANGED
|
@@ -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`
|
|
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
|
|
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
|
|
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
|
|
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,
|
package/dist/signal-grid.js
CHANGED
|
@@ -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`
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
41
|
-
* albo rozmiaru
|
|
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
|
|
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
|
|
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
|
|
56
|
-
* Wynik zawsze zawija się do 0
|
|
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
|
|
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
|
|
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
|
|
47
|
-
* albo rozmiaru
|
|
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
|
|
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
|
|
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
|
|
102
|
-
* Wynik zawsze zawija się do 0
|
|
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.
|
|
4
|
-
"description": "Animated backdrop core for Koncept UI
|
|
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.
|
|
40
|
+
"@konce-pt/color": "0.14.0"
|
|
41
41
|
},
|
|
42
42
|
"devDependencies": {
|
|
43
43
|
"typescript": "~6.0.3"
|