@cat-of-summer/st-script 1.3.2 → 1.4.1

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.
@@ -0,0 +1,61 @@
1
+ // Фигура с вырезами: путь из Figma → путь под реальный размер элемента. Чистые функции без DOM.
2
+ //
3
+ // Значение атрибута — "ширина высота | d": размер фрейма в px макета и путь Figma как есть
4
+ // (абсолютные M L H V C S Q Z). Кривые — скругления углов в пару px — заменяются отрезком
5
+ // до конечной точки.
6
+
7
+ export const parse = (value) => {
8
+ let [size, d] = String(value ?? '').split('|');
9
+ let [w, h] = (size ?? '').trim().split(/\s+/).map(Number);
10
+ if (!(w > 0 && h > 0) || !d) return null;
11
+
12
+ let points = [], x = 0, y = 0;
13
+
14
+ for (let [, cmd, args] of d.matchAll(/([MLHVZCSQ])([^MLHVZCSQ]*)/gi)) {
15
+ let nums = (args.match(/-?\d*\.?\d+(?:e-?\d+)?/gi) || []).map(Number);
16
+ switch (cmd.toUpperCase()) {
17
+ case 'M':
18
+ case 'L':
19
+ for (let i = 0; i + 1 < nums.length; i += 2) points.push([x = nums[i], y = nums[i + 1]]);
20
+ break;
21
+ case 'H':
22
+ for (let n of nums) points.push([x = n, y]);
23
+ break;
24
+ case 'V':
25
+ for (let n of nums) points.push([x, y = n]);
26
+ break;
27
+ case 'C':
28
+ for (let i = 0; i + 5 < nums.length; i += 6) points.push([x = nums[i + 4], y = nums[i + 5]]);
29
+ break;
30
+ case 'S':
31
+ case 'Q':
32
+ for (let i = 0; i + 3 < nums.length; i += 4) points.push([x = nums[i + 2], y = nums[i + 3]]);
33
+ break;
34
+ }
35
+ }
36
+
37
+ return points.length > 2 ? { w, h, points } : null;
38
+ };
39
+
40
+ // Каждая точка привязывается к ближнему краю: x левее середины фрейма считается от левого
41
+ // края, правее — от правого; так же по y. Вырезы сохраняют размер, прямые участки тянутся
42
+ // под реальный размер. k — px экрана на px макета (rem / scale): вырезы масштабируются
43
+ // вместе с вёрсткой на rem.
44
+ export const build = (shape, width, height, k = 1) => 'M' + shape.points.map(([x, y]) => {
45
+ let px = x <= shape.w / 2 ? x * k : width - (shape.w - x) * k;
46
+ let py = y <= shape.h / 2 ? y * k : height - (shape.h - y) * k;
47
+ return `${+px.toFixed(2)} ${+py.toFixed(2)}`;
48
+ }).join('L') + 'Z';
49
+
50
+ // Фигура для ширины окна: самый широкий брейкпоинт, чей min не больше width и для которого
51
+ // задана своя фигура; иначе — base. variants: { base, md: shape, … }, breakpoints: { md: 768, … }.
52
+ export const pick = (variants, breakpoints, width) => {
53
+ let best = variants.base, min = -1;
54
+ for (let [bp, shape] of Object.entries(variants)) {
55
+ let from = breakpoints[bp];
56
+ if (bp == 'base' || !shape || from == null || from > width || from < min) continue;
57
+ best = shape;
58
+ min = from;
59
+ }
60
+ return best;
61
+ };
@@ -0,0 +1,167 @@
1
+ import { elements, find, own, disown } from '../_traits/hasInstanceSymbol.js';
2
+ import { parse, build, pick } from './_engine.js';
3
+
4
+ const NS = 'http://www.w3.org/2000/svg';
5
+ const CALLBACKS = ['before_init', 'on_init', 'on_draw'];
6
+
7
+ // Фигуры с вырезанными углами по путям из Figma. Внутрь элемента первым ребёнком кладётся
8
+ // <svg class="cut-shape"><path/></svg> — фон и обводка (цвета задаёт CSS, st-style [cut]), — а сам
9
+ // элемент клипается тем же путём. Форма пересчитывается при смене размера элемента, брейкпоинта
10
+ // и атрибутов.
11
+ export default class Cut {
12
+
13
+ static #CONFIG = ['target'];
14
+
15
+ #params = {};
16
+ #methods = {};
17
+ #shapes = new Map();
18
+ #pending = new Set();
19
+ #frame = 0;
20
+ #abort = new AbortController();
21
+ #ro = new ResizeObserver(entries => this.#schedule(entries.map(e => e.target)));
22
+ #mo = new MutationObserver(records => {
23
+ for (let { target } of records) this.#read(target);
24
+ this.#schedule(records.map(r => r.target));
25
+ });
26
+
27
+ static find = find;
28
+
29
+ get params() { return this.#params; }
30
+
31
+ get elements() { return [...this.#shapes.keys()]; }
32
+
33
+ clone(params) {
34
+ return new Cut({ ...this.#params, ...this.#methods, ...params, parent: this });
35
+ }
36
+
37
+ constructor(params) {
38
+ params = {
39
+ target: '[cut]',
40
+ attribute: 'cut',
41
+ // Шкала st-style по умолчанию: фигура для брейкпоинта — атрибут cut-<ключ>, действует от min и шире.
42
+ breakpoints: { xs: 360, sm: 576, md: 768, lp: 1024, lg: 1280, dt: 1536, xl: 1920 },
43
+ // px макета в 1rem: координаты переводятся в rem и масштабируются вместе с вёрсткой.
44
+ // 0 — без масштаба, 1px макета = 1px экрана.
45
+ scale: 10,
46
+ ...Object.fromEntries(CALLBACKS.map(k => [k, () => {}])),
47
+ ...params
48
+ };
49
+
50
+ for (let [key, value] of Object.entries(params))
51
+ if (typeof value == 'function' && !Cut.#CONFIG.includes(key)) {
52
+ this[key] = value.bind(this);
53
+ this.#methods[key] = value;
54
+ } else
55
+ this.#params[key] = value;
56
+
57
+ this.before_init(this.#params);
58
+
59
+ let signal = this.#abort.signal, redraw = () => this.#schedule(this.elements);
60
+ for (let min of Object.values(this.#params.breakpoints))
61
+ matchMedia(`(min-width: ${min}px)`).addEventListener('change', redraw, { signal });
62
+
63
+ for (let el of elements(this.#params.target)) this.#bind(el);
64
+
65
+ this.on_init(this.#params);
66
+ }
67
+
68
+ #names() {
69
+ let a = this.#params.attribute;
70
+ return [a, ...Object.keys(this.#params.breakpoints).map(bp => `${a}-${bp}`)];
71
+ }
72
+
73
+ #bind(el) {
74
+ if (this.#shapes.has(el)) return;
75
+ let owner = find(el);
76
+ if (owner instanceof Cut && owner !== this) return;
77
+
78
+ own(el, this);
79
+
80
+ let svg = document.createElementNS(NS, 'svg');
81
+ let path = document.createElementNS(NS, 'path');
82
+ svg.classList.add('cut-shape');
83
+ svg.setAttribute('aria-hidden', 'true');
84
+ svg.setAttribute('preserveAspectRatio', 'none');
85
+ svg.append(path);
86
+ el.prepend(svg);
87
+
88
+ this.#shapes.set(el, { svg, path, clip: el.style.clipPath, variants: {} });
89
+ this.#read(el);
90
+ this.#draw(el);
91
+
92
+ this.#ro.observe(el);
93
+ this.#mo.observe(el, { attributes: true, attributeFilter: this.#names() });
94
+ }
95
+
96
+ #read(el) {
97
+ let data = this.#shapes.get(el);
98
+ if (!data) return;
99
+ let a = this.#params.attribute;
100
+ data.variants = { base: parse(el.getAttribute(a)) };
101
+ for (let bp of Object.keys(this.#params.breakpoints))
102
+ if (el.hasAttribute(`${a}-${bp}`)) data.variants[bp] = parse(el.getAttribute(`${a}-${bp}`));
103
+ }
104
+
105
+ // Пересчёт пачкой в кадре: ResizeObserver и смена брейкпоинта приходят на много элементов сразу.
106
+ #schedule(list) {
107
+ for (let el of list) this.#pending.add(el);
108
+ this.#frame ||= requestAnimationFrame(() => {
109
+ this.#frame = 0;
110
+ let batch = [...this.#pending];
111
+ this.#pending.clear();
112
+ batch.forEach(el => this.#draw(el));
113
+ });
114
+ }
115
+
116
+ #draw(el) {
117
+ let data = this.#shapes.get(el);
118
+ if (!data) return;
119
+
120
+ let shape = pick(data.variants, this.#params.breakpoints, innerWidth);
121
+ let { width, height } = el.getBoundingClientRect();
122
+ if (!shape || !width || !height) {
123
+ data.path.removeAttribute('d');
124
+ el.style.clipPath = data.clip;
125
+ return;
126
+ }
127
+
128
+ let scale = this.#params.scale;
129
+ let k = scale ? parseFloat(getComputedStyle(document.documentElement).fontSize) / scale : 1;
130
+ let d = build(shape, width, height, k);
131
+
132
+ data.path.setAttribute('d', d);
133
+ data.svg.setAttribute('viewBox', `0 0 ${width} ${height}`);
134
+ el.style.clipPath = `path("${d}")`;
135
+
136
+ this.on_draw(el, d);
137
+ }
138
+
139
+ // Перечитать атрибуты и перерисовать; новые элементы под target — взять под управление.
140
+ refresh(target = this.#params.target) {
141
+ for (let el of elements(target)) {
142
+ if (!this.#shapes.has(el)) { this.#bind(el); continue; }
143
+ this.#read(el);
144
+ this.#draw(el);
145
+ }
146
+ return this;
147
+ }
148
+
149
+ // Разобрать: снять наблюдатели и слушатели, убрать svg, вернуть прежний clip-path.
150
+ destroy() {
151
+ this.#abort.abort();
152
+ this.#ro.disconnect();
153
+ this.#mo.disconnect();
154
+ cancelAnimationFrame(this.#frame);
155
+ this.#frame = 0;
156
+ this.#pending.clear();
157
+
158
+ for (let [el, { svg, clip }] of this.#shapes) {
159
+ svg.remove();
160
+ el.style.clipPath = clip;
161
+ if (!el.getAttribute('style')) el.removeAttribute('style');
162
+ disown(el, this);
163
+ }
164
+
165
+ this.#shapes.clear();
166
+ }
167
+ }
package/src/index.js CHANGED
@@ -14,3 +14,4 @@ export { default as Toggle } from './toggle/index.js';
14
14
  export { default as Typograf } from './typograf/index.js';
15
15
  export { default as Uploader } from './uploader/index.js';
16
16
  export { default as Validator } from './validator/index.js';
17
+ export { default as Cut } from './cut/index.js';
@@ -1,6 +1,8 @@
1
- import { disown, elements, expose, find, own } from '../_traits/hasInstanceSymbol.js';
1
+ import { disown, element, elements, expose, find, own } from '../_traits/hasInstanceSymbol.js';
2
2
 
3
3
 
4
+ const active = el => ['active', 'activating'].includes(el.getAttribute('state'));
5
+
4
6
  export default class Toggle {
5
7
 
6
8
  #params = {};
@@ -11,6 +13,14 @@ export default class Toggle {
11
13
  #triggers = [];
12
14
  #last = null;
13
15
  #abort = new AbortController();
16
+ // Индикатор и триггер, за которым он следует (последний начавший активацию).
17
+ #indicator = null;
18
+ #current = null;
19
+ // ResizeObserver: пересчёт индикатора и доводка, отложенная до показа скрытых табов.
20
+ #resize = null;
21
+ #deferred = null;
22
+ // До конца конструктора индикатор и доводка — без анимации: страница только открылась.
23
+ #ready = false;
14
24
 
15
25
  static find = find;
16
26
 
@@ -35,6 +45,8 @@ export default class Toggle {
35
45
  anchor: false,
36
46
  keep_history: false,
37
47
  group: false,
48
+ indicator: null,
49
+ reveal: false,
38
50
 
39
51
  before_activate: () => {},
40
52
  on_activate: () => {},
@@ -55,7 +67,7 @@ export default class Toggle {
55
67
  if (params.keep_history) params.anchor = true;
56
68
 
57
69
  for (let [key, value] of Object.entries(params))
58
- if (typeof value == "function" && key != 'target') {
70
+ if (typeof value == "function" && key != 'target' && key != 'indicator') {
59
71
  this[key] = value.bind(this);
60
72
 
61
73
  this.#methods[key] = value;
@@ -88,19 +100,41 @@ export default class Toggle {
88
100
  trigger.addEventListener(this.#params.action, () => this.toggle(trigger), { signal });
89
101
  }
90
102
 
103
+ let indicator = this.#params.indicator;
104
+ this.#indicator = element(typeof indicator == 'function' ? indicator(this) : indicator) ?? null;
105
+
91
106
  if (this.#params.anchor) {
92
107
  this.#applyHash();
93
108
  if (this.#params.keep_history)
94
109
  window.addEventListener('hashchange', () => this.#applyHash(), { signal });
95
110
  }
96
111
 
112
+ // Стартовый активный триггер из разметки: якорь его не выбрал — доводим и ставим индикатор.
113
+ if (!this.#current && (this.#current = this.#triggers.filter(active).at(-1) ?? null))
114
+ this.#reveal(this.#current);
115
+
116
+ if (this.#indicator) {
117
+ this.#indicate();
118
+ this.#observe();
119
+ // Индикатор вне прокручиваемой ленты следует за ней; внутри ленты координаты не меняются.
120
+ document.addEventListener('scroll', e => {
121
+ let t = e.target;
122
+ if (t !== document && this.#current && t.contains(this.#current) && !t.contains(this.#indicator))
123
+ this.#indicate(true);
124
+ }, { capture: true, passive: true, signal });
125
+ }
126
+
127
+ this.#ready = true;
128
+
97
129
  this.on_init(this.#params);
98
130
  }
99
131
 
100
- // Разобрать: снять обработчики (в том числе hashchange на window) и таймеры переходов.
101
- // state на триггерах и целях остаётся как есть.
132
+ // Разобрать: снять обработчики (в том числе hashchange на window), таймеры переходов и
133
+ // ResizeObserver. state на триггерах и целях и переменные индикатора остаются как есть.
102
134
  destroy() {
103
135
  this.#abort.abort();
136
+ this.#resize?.disconnect();
137
+ this.#resize = this.#deferred = this.#indicator = this.#current = null;
104
138
  this.#pending.forEach(clearTimeout);
105
139
  this.#pending.clear();
106
140
  this.#triggers.forEach(trigger => disown(trigger, this, ['toggle', 'activate', 'deactivate']));
@@ -148,7 +182,8 @@ export default class Toggle {
148
182
  #applyHash() {
149
183
  let trigger = this.#anchors.get(location.hash.slice(1));
150
184
 
151
- if (trigger) this.activate(trigger);
185
+ // Таб из ссылки выбрал не пользователь — доводим до видимости всегда, без reveal.
186
+ if (trigger) this.#act(trigger, true, true);
152
187
  else if (this.#params.keep_history && this.#last) {
153
188
  this.deactivate(this.#last);
154
189
  this.#last = null;
@@ -173,7 +208,106 @@ export default class Toggle {
173
208
  });
174
209
  }
175
210
 
176
- #act(trigger, on) {
211
+ // Пересчитать индикатор. Мгновенно (без transition) — при ресайзе, прокрутке и первой
212
+ // расстановке, иначе он отстаёт или выезжает из нуля; анимированно — при смене триггера.
213
+ #indicate(instant = !this.#ready) {
214
+ let el = this.#indicator, t = this.#current;
215
+ if (!el) return;
216
+
217
+ instant ||= el.getAttribute('state') != 'active';
218
+ el.setAttribute('state', t ? 'active' : 'inactive');
219
+
220
+ // Координаты — от offsetParent индикатора, с его прокруткой: индикатор внутри ленты
221
+ // прокручивается вместе с ней.
222
+ let p = el.offsetParent;
223
+ if (!t || !p || !t.getClientRects().length) return;
224
+
225
+ let r = t.getBoundingClientRect(), pr = p.getBoundingClientRect(), transition = el.style.transition;
226
+ if (instant) el.style.transition = 'none';
227
+
228
+ Object.entries({
229
+ x: r.left - pr.left - p.clientLeft + p.scrollLeft,
230
+ y: r.top - pr.top - p.clientTop + p.scrollTop,
231
+ width: r.width,
232
+ height: r.height,
233
+ }).forEach(([key, value]) => el.style.setProperty('--indicator-' + key, value + 'px'));
234
+
235
+ if (instant) {
236
+ el.offsetWidth;
237
+ el.style.transition = transition;
238
+ }
239
+ }
240
+
241
+ // Довести триггер до полной видимости в ближайшей горизонтальной ленте с прокруткой.
242
+ // Только эта лента и только по горизонтали: страница не двигается. scrollLeft — абсолютный,
243
+ // а не scrollBy: при быстрых кликах плавная прокрутка ещё идёт, и приращения накопились бы.
244
+ #reveal(trigger, instant = !this.#ready) {
245
+ // Табы скрыты (закрытая модалка, панель) — размеров нет, доводим при показе.
246
+ if (!trigger.getClientRects().length) {
247
+ this.#deferred = trigger;
248
+ return this.#observe();
249
+ }
250
+
251
+ let box = trigger.parentElement, css;
252
+ while (box && !(box.scrollWidth > box.clientWidth && /auto|scroll/.test((css = getComputedStyle(box)).overflowX)))
253
+ box = box.parentElement;
254
+ if (!box) return;
255
+
256
+ let r = trigger.getBoundingClientRect(),
257
+ start = box.getBoundingClientRect().left + box.clientLeft,
258
+ left = start + (parseFloat(css.scrollPaddingLeft) || 0),
259
+ right = start + box.clientWidth - (parseFloat(css.scrollPaddingRight) || 0),
260
+ rtl = css.direction == 'rtl';
261
+
262
+ // Шире ленты — к начальному краю (в RTL — к правому).
263
+ let delta = r.width > right - left ? (rtl ? r.right - right : r.left - left)
264
+ : r.left < left ? r.left - left
265
+ : r.right > right ? r.right - right : 0;
266
+ if (Math.abs(delta) < 1) return;
267
+
268
+ // scroll-snap: лента прилипла бы к ближайшей точке, и таб снова ушёл бы за край.
269
+ // Берём ближайшую к текущему положению точку, где таб виден целиком.
270
+ if (/^(x|inline|both)/.test(css.scrollSnapType)) {
271
+ let max = box.scrollWidth - box.clientWidth, now = box.scrollLeft, best = null;
272
+ for (let el of box.querySelectorAll('*')) {
273
+ let align = getComputedStyle(el).scrollSnapAlign.split(' ').at(-1);
274
+ if (align == 'none') continue;
275
+ if (rtl && align != 'center') align = align == 'start' ? 'end' : 'start';
276
+
277
+ let e = el.getBoundingClientRect(),
278
+ d = align == 'start' ? e.left - left : align == 'end' ? e.right - right : (e.left + e.right - left - right) / 2;
279
+ // Точка за пределом прокрутки прижимается к краю (в RTL scrollLeft от -max до 0).
280
+ d = Math.min(Math.max(now + d, rtl ? -max : 0), rtl ? 0 : max) - now;
281
+
282
+ if (r.left - d >= left - 0.5 && r.right - d <= right + 0.5 && (best === null || Math.abs(d) < Math.abs(best)))
283
+ best = d;
284
+ }
285
+ delta = best ?? delta;
286
+ }
287
+
288
+ let behavior = box.style.scrollBehavior;
289
+ if (instant) box.style.scrollBehavior = 'auto';
290
+ box.scrollLeft += delta;
291
+ if (instant) box.style.scrollBehavior = behavior;
292
+ }
293
+
294
+ #observe() {
295
+ if (this.#resize || typeof ResizeObserver == 'undefined') return;
296
+
297
+ this.#resize = new ResizeObserver(() => {
298
+ let t = this.#deferred;
299
+ if (t?.getClientRects().length) {
300
+ this.#deferred = null;
301
+ this.#reveal(t, true);
302
+ }
303
+ this.#indicate(true);
304
+ });
305
+
306
+ // Контейнер индикатора: ширина ленты меняется, а позиции табов (по центру) — вслед за ней.
307
+ [...this.#triggers, this.#indicator?.parentElement].forEach(el => el && this.#resize.observe(el));
308
+ }
309
+
310
+ #act(trigger, on, reveal = false) {
177
311
  let state = trigger.getAttribute('state') ?? 'inactive', ai = this.#params.allow_interrupt;
178
312
 
179
313
  if (!(on ? state == 'inactive' || ai && state == 'deactivating'
@@ -184,11 +318,21 @@ export default class Toggle {
184
318
  final = on ? 'active' : 'inactive',
185
319
  targets = this.#targets(trigger);
186
320
 
321
+ // Индикатор переезжает сразу, вместе с activating. Выключили тот, за кем он шёл, —
322
+ // к оставшемуся активному или гаснет (state="inactive").
323
+ let moved = on || trigger === this.#current;
324
+ if (on) this.#current = trigger;
325
+ else if (moved)
326
+ this.#current = this.#triggers.filter(t => t !== trigger && active(t)).at(-1) ?? null;
327
+
187
328
  if (on && this.#params.group)
188
329
  this.#triggers
189
- .filter(t => t !== trigger && ['active', 'activating'].includes(t.getAttribute('state')))
330
+ .filter(t => t !== trigger && active(t))
190
331
  .forEach(t => this.#act(t, false));
191
332
 
333
+ if (moved) this.#indicate();
334
+ if (on && reveal) this.#reveal(trigger);
335
+
192
336
  let id = this.#anchorId(trigger);
193
337
  if (id) {
194
338
  if (on) { this.#writeHash(id); this.#last = trigger; }
@@ -202,13 +346,17 @@ export default class Toggle {
202
346
  el => this[`before_${verb}d`](el, trigger), el => this[`on_${verb}d`](el, trigger));
203
347
  }
204
348
 
349
+ // Клик и вызов из кода доводят таб до видимости по reveal; при hover — никогда:
350
+ // наведение на крайний пункт прокрутило бы меню под курсором.
351
+ get #revealing() { return this.#params.reveal && this.#params.action != 'hover'; }
352
+
205
353
  toggle(el) {
206
354
  elements(el).forEach(t => {
207
- let on = !['active', 'activating'].includes(t.getAttribute('state'));
208
- if (on || this.#params.group != 'radio') this.#act(t, on);
355
+ let on = !active(t);
356
+ if (on || this.#params.group != 'radio') this.#act(t, on, this.#revealing);
209
357
  });
210
358
  }
211
359
 
212
- activate(el) { elements(el).forEach(t => this.#act(t, true)); }
360
+ activate(el) { elements(el).forEach(t => this.#act(t, true, this.#revealing)); }
213
361
  deactivate(el) { elements(el).forEach(t => this.#act(t, false)); }
214
362
  }