blueprintsjs 0.0.0-stage → 0.2.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.
Files changed (85) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/LICENSE +21 -0
  3. package/README.md +165 -2
  4. package/dist/blueprintsjs.umd.cjs +325 -0
  5. package/dist/blueprintsjs.umd.cjs.map +1 -0
  6. package/dist/chunks/validate-DHOIGyop.js +860 -0
  7. package/dist/chunks/validate-DHOIGyop.js.map +1 -0
  8. package/dist/chunks/validate-Ddbqd8bD.cjs +859 -0
  9. package/dist/chunks/validate-Ddbqd8bD.cjs.map +1 -0
  10. package/dist/core/build.d.cts +33 -0
  11. package/dist/core/build.d.ts +33 -0
  12. package/dist/core/compile.d.cts +27 -0
  13. package/dist/core/compile.d.ts +27 -0
  14. package/dist/core/helpers.d.cts +13 -0
  15. package/dist/core/helpers.d.ts +13 -0
  16. package/dist/core/layout.d.cts +19 -0
  17. package/dist/core/layout.d.ts +19 -0
  18. package/dist/core/registry.d.cts +23 -0
  19. package/dist/core/registry.d.ts +23 -0
  20. package/dist/core/schema.d.cts +14 -0
  21. package/dist/core/schema.d.ts +14 -0
  22. package/dist/core/types.d.cts +215 -0
  23. package/dist/core/types.d.ts +215 -0
  24. package/dist/core/validate.d.cts +9 -0
  25. package/dist/core/validate.d.ts +9 -0
  26. package/dist/editor/GraphEditor.d.cts +181 -0
  27. package/dist/editor/GraphEditor.d.ts +181 -0
  28. package/dist/editor/details.d.cts +23 -0
  29. package/dist/editor/details.d.ts +23 -0
  30. package/dist/editor/dom.d.cts +20 -0
  31. package/dist/editor/dom.d.ts +20 -0
  32. package/dist/editor/highlight.d.cts +7 -0
  33. package/dist/editor/highlight.d.ts +7 -0
  34. package/dist/editor/index.d.cts +13 -0
  35. package/dist/editor/index.d.ts +13 -0
  36. package/dist/editor/state.d.cts +113 -0
  37. package/dist/editor/state.d.ts +113 -0
  38. package/dist/editor/styles.d.cts +7 -0
  39. package/dist/editor/styles.d.ts +7 -0
  40. package/dist/editor.cjs +2196 -0
  41. package/dist/editor.cjs.map +1 -0
  42. package/dist/editor.js +2196 -0
  43. package/dist/editor.js.map +1 -0
  44. package/dist/index.cjs +1251 -0
  45. package/dist/index.cjs.map +1 -0
  46. package/dist/index.d.cts +21 -0
  47. package/dist/index.d.ts +21 -0
  48. package/dist/index.js +1252 -0
  49. package/dist/index.js.map +1 -0
  50. package/dist/locales/index.d.cts +15 -0
  51. package/dist/locales/index.d.ts +15 -0
  52. package/dist/locales/ru.d.cts +3 -0
  53. package/dist/locales/ru.d.ts +3 -0
  54. package/dist/locales/uk.d.cts +3 -0
  55. package/dist/locales/uk.d.ts +3 -0
  56. package/dist/locales.cjs +579 -0
  57. package/dist/locales.cjs.map +1 -0
  58. package/dist/locales.js +579 -0
  59. package/dist/locales.js.map +1 -0
  60. package/dist/nodes/data.d.cts +26 -0
  61. package/dist/nodes/data.d.ts +26 -0
  62. package/dist/nodes/dom.d.cts +27 -0
  63. package/dist/nodes/dom.d.ts +27 -0
  64. package/dist/nodes/events.d.cts +11 -0
  65. package/dist/nodes/events.d.ts +11 -0
  66. package/dist/nodes/flow.d.cts +10 -0
  67. package/dist/nodes/flow.d.ts +10 -0
  68. package/dist/nodes/index.d.cts +11 -0
  69. package/dist/nodes/index.d.ts +11 -0
  70. package/dist/nodes/lib.d.cts +7 -0
  71. package/dist/nodes/lib.d.ts +7 -0
  72. package/dist/umd.d.cts +5 -0
  73. package/dist/umd.d.ts +5 -0
  74. package/dist/version.d.cts +2 -0
  75. package/dist/version.d.ts +2 -0
  76. package/docs/compiler.md +149 -0
  77. package/docs/custom-nodes.md +119 -0
  78. package/docs/editor.md +166 -0
  79. package/docs/guide.md +79 -0
  80. package/docs/nodes.md +494 -0
  81. package/docs/nodes.ru.md +494 -0
  82. package/docs/schema.md +64 -0
  83. package/examples/index.html +110 -0
  84. package/package.json +107 -4
  85. package/schema/blueprint.schema.json +102 -0
@@ -0,0 +1,494 @@
1
+ # Справочник блоков
2
+
3
+ Сгенерировано из реестра нод (`scripts/gen-nodes.mjs`). Типы пинов: `exec` (порядок выполнения), `string`, `number`, `boolean`, `element`, `elements`, `event`, `object`, `any`. Текст на пине элемента — это CSS-селектор.
4
+
5
+ ## События
6
+
7
+ ### Событие элемента — `event.element`
8
+
9
+ Срабатывает при событии на элементе, подходящем под селектор, — на всех страницах и для элементов, добавленных позже. Без селектора — сам корень (элемент компонента).
10
+
11
+ - **Входы:** —
12
+ - **Выходы:** `exec`, `element` Элемент, `event` Событие
13
+ - **Настройки:** Селектор (`selector`), Событие (`event` = `"click"`; `click` `dblclick` `contextmenu` `mousedown` `mouseup` `mouseenter` `mouseleave` `pointerdown` `pointerup` `touchstart` `touchend` `input` `change` `submit` `reset` `focus` `blur` `keydown` `keyup` `animationend` `transitionend`), Отменить действие браузера (`preventDefault` = `false`), Остановить всплытие (`stopPropagation` = `false`), Только один раз (`once` = `false`)
14
+
15
+ ### При запуске — `event.start`
16
+
17
+ Срабатывает один раз при запуске: когда страница готова или когда появился экземпляр компонента.
18
+
19
+ - **Входы:** —
20
+ - **Выходы:** `exec`, `element` Корень
21
+
22
+ ### Событие страницы — `event.page`
23
+
24
+ События окна и документа: загрузка, прокрутка, изменение размера, смена hash, видимость вкладки…
25
+
26
+ - **Входы:** —
27
+ - **Выходы:** `exec`, `event` Событие
28
+ - **Настройки:** Событие (`event` = `"scroll"`; `load` `scroll` `resize` `hashchange` `popstate` `visibilitychange` `online` `offline` `beforeunload`), Не чаще, мс (`throttle` = `0`)
29
+
30
+ ### Таймер — `event.timer`
31
+
32
+ Срабатывает через заданное время или каждые N миллисекунд, если включён «Повтор».
33
+
34
+ - **Входы:** —
35
+ - **Выходы:** `exec`
36
+ - **Настройки:** Миллисекунды (`ms` = `1000`), Повтор (`repeat` = `false`)
37
+
38
+ ### Клавиша — `event.key`
39
+
40
+ Срабатывает при нажатии клавиши на странице (например Escape). Пустая клавиша — любая.
41
+
42
+ - **Входы:** —
43
+ - **Выходы:** `exec`, `event` Событие
44
+ - **Настройки:** Клавиша (`key` = `"Escape"`; `Escape` `Enter` ` ` `ArrowLeft` `ArrowRight` `ArrowUp` `ArrowDown` `Tab`), Событие (`event` = `"keydown"`; `keydown` `keyup`), Ctrl / ⌘ (`ctrl` = `false`), Shift (`shift` = `false`), Alt (`alt` = `false`), Отменить действие браузера (`preventDefault` = `false`)
45
+
46
+ ### Своё событие — `event.custom`
47
+
48
+ Срабатывает, когда до корня доходит событие с этим именем (см. «Отправить событие»). Так блюпринты общаются между собой.
49
+
50
+ - **Входы:** —
51
+ - **Выходы:** `exec`, `any` Данные, `element` Отправитель
52
+ - **Настройки:** Имя события (`name` = `"my-event"`)
53
+
54
+ ## Поток
55
+
56
+ ### Условие — `flow.branch`
57
+
58
+ Если условие истинно — выполняет «Да», иначе «Нет».
59
+
60
+ - **Входы:** `exec`, `boolean` Условие = `false`
61
+ - **Выходы:** `exec` Да, `exec` Нет
62
+
63
+ ### Последовательность — `flow.sequence`
64
+
65
+ Выполняет выходы по очереди сверху вниз.
66
+
67
+ *пины зависят от настроек*
68
+
69
+ - **Входы:** `exec`
70
+ - **Выходы:** `exec` Затем 0, `exec` Затем 1
71
+ - **Настройки:** Выходы (`count` = `2`)
72
+
73
+ ### Задержка — `flow.delay`
74
+
75
+ Ждёт, потом продолжает.
76
+
77
+ - **Входы:** `exec`, `number` Миллисекунды = `300`
78
+ - **Выходы:** `exec`
79
+
80
+ ### Debounce — `flow.debounce`
81
+
82
+ Продолжает только когда вызовы прекратились на заданное время (ввод текста, ресайз).
83
+
84
+ - **Входы:** `exec`, `number` Миллисекунды = `300`
85
+ - **Выходы:** `exec`
86
+
87
+ ### Throttle — `flow.throttle`
88
+
89
+ Продолжает не чаще, чем раз в заданное время.
90
+
91
+ - **Входы:** `exec`, `number` Миллисекунды = `200`
92
+ - **Выходы:** `exec`
93
+
94
+ ### Один раз — `flow.doOnce`
95
+
96
+ Продолжает только в первый раз — до «Сброса».
97
+
98
+ - **Входы:** `exec`, `exec` Сброс
99
+ - **Выходы:** `exec`
100
+
101
+ ### Для каждого — `flow.forEach`
102
+
103
+ Выполняет «Тело цикла» для каждого элемента (найденные элементы, массив…), затем «Завершено».
104
+
105
+ - **Входы:** `exec`, `any` Элементы
106
+ - **Выходы:** `exec` Тело цикла, `any` Элемент, `number` Индекс, `exec` Завершено
107
+
108
+ ### Выбор — `flow.switch`
109
+
110
+ Выполняет выход, чей вариант равен значению, иначе «По умолчанию». Варианты — через запятую.
111
+
112
+ *пины зависят от настроек*
113
+
114
+ - **Входы:** `exec`, `any` Значение
115
+ - **Выходы:** `exec` a, `exec` b, `exec` По умолчанию
116
+ - **Настройки:** Варианты (`cases` = `"a, b"`)
117
+
118
+ ## Элементы
119
+
120
+ ### Найти элементы — `dom.query`
121
+
122
+ Находит элементы по CSS-селектору: во всём документе (или компоненте), внутри заданных элементов или ближайшего предка.
123
+
124
+ - **Входы:** `string` Селектор, `elements` От
125
+ - **Выходы:** `elements` Элементы, `element` Первый, `number` Количество
126
+ - **Настройки:** Где (`mode` = `"all"`; `all` `within` `closest`)
127
+
128
+ ### Корневой элемент — `dom.root`
129
+
130
+ Элемент компонента (для компонентных блюпринтов) или <html> (для страничных).
131
+
132
+ - **Входы:** —
133
+ - **Выходы:** `element` Элемент
134
+
135
+ ### Добавить класс — `dom.addClass`
136
+
137
+ Добавляет класс(ы) элементам. Несколько классов — через пробел.
138
+
139
+ - **Входы:** `exec`, `elements` Цель, `string` Класс
140
+ - **Выходы:** `exec`
141
+
142
+ ### Убрать класс — `dom.removeClass`
143
+
144
+ Убирает класс(ы) у элементов.
145
+
146
+ - **Входы:** `exec`, `elements` Цель, `string` Класс
147
+ - **Выходы:** `exec`
148
+
149
+ ### Переключить класс — `dom.toggleClass`
150
+
151
+ Добавляет класс, если его нет, иначе убирает.
152
+
153
+ - **Входы:** `exec`, `elements` Цель, `string` Класс
154
+ - **Выходы:** `exec`
155
+
156
+ ### Есть класс — `dom.hasClass`
157
+
158
+ Истина, если хотя бы у одного элемента есть класс.
159
+
160
+ - **Входы:** `elements` Цель, `string` Класс
161
+ - **Выходы:** `boolean` Результат
162
+
163
+ ### Подходит под селектор — `dom.matches`
164
+
165
+ Истина, если элемент подходит под CSS-селектор (например, клик был по самому фону).
166
+
167
+ - **Входы:** `element` Элемент, `string` Селектор
168
+ - **Выходы:** `boolean` Результат
169
+
170
+ ### Задать атрибут — `dom.setAttribute`
171
+
172
+ Задаёт атрибут (aria-expanded, data-state…).
173
+
174
+ - **Входы:** `exec`, `elements` Цель, `string` Имя, `string` Значение
175
+ - **Выходы:** `exec`
176
+
177
+ ### Убрать атрибут — `dom.removeAttribute`
178
+
179
+ Убирает атрибут.
180
+
181
+ - **Входы:** `exec`, `elements` Цель, `string` Имя
182
+ - **Выходы:** `exec`
183
+
184
+ ### Прочитать атрибут — `dom.getAttribute`
185
+
186
+ Атрибут первого элемента (пустая строка, если нет).
187
+
188
+ - **Входы:** `elements` Цель, `string` Имя
189
+ - **Выходы:** `string` Значение
190
+
191
+ ### Задать стиль — `dom.setStyle`
192
+
193
+ Задаёт inline CSS-свойство (пустое значение убирает его).
194
+
195
+ - **Входы:** `exec`, `elements` Цель, `string` Свойство, `string` Значение
196
+ - **Выходы:** `exec`
197
+
198
+ ### Задать текст — `dom.setText`
199
+
200
+ Заменяет текст элементов (безопасно: HTML не разбирается).
201
+
202
+ - **Входы:** `exec`, `elements` Цель, `string` Текст
203
+ - **Выходы:** `exec`
204
+
205
+ ### Прочитать текст — `dom.getText`
206
+
207
+ Текст первого элемента.
208
+
209
+ - **Входы:** `elements` Цель
210
+ - **Выходы:** `string` Текст
211
+
212
+ ### Задать HTML (небезопасно) — `dom.setHtml`
213
+
214
+ Заменяет внутренний HTML. Никогда не передавайте сюда ввод пользователя: это может запустить чужой скрипт (XSS). Лучше «Задать текст».
215
+
216
+ - **Входы:** `exec`, `elements` Цель, `string` HTML
217
+ - **Выходы:** `exec`
218
+
219
+ ### Прочитать значение — `dom.getValue`
220
+
221
+ Значение первого поля формы (флажок — отмечен или нет).
222
+
223
+ - **Входы:** `elements` Цель
224
+ - **Выходы:** `any` Значение
225
+
226
+ ### Задать значение — `dom.setValue`
227
+
228
+ Задаёт значение полей формы (флажок отмечается, если значение истинно).
229
+
230
+ - **Входы:** `exec`, `elements` Цель, `any` Значение
231
+ - **Выходы:** `exec`
232
+
233
+ ### Показать — `dom.show`
234
+
235
+ Делает скрытые элементы видимыми (убирает display: none / hidden).
236
+
237
+ - **Входы:** `exec`, `elements` Цель
238
+ - **Выходы:** `exec`
239
+
240
+ ### Скрыть — `dom.hide`
241
+
242
+ Скрывает элементы (display: none).
243
+
244
+ - **Входы:** `exec`, `elements` Цель
245
+ - **Выходы:** `exec`
246
+
247
+ ### Показать / скрыть — `dom.toggleVisible`
248
+
249
+ Показывает скрытые элементы и скрывает видимые.
250
+
251
+ - **Входы:** `exec`, `elements` Цель
252
+ - **Выходы:** `exec`
253
+
254
+ ### Виден ли — `dom.isVisible`
255
+
256
+ Истина, если первый элемент отображается.
257
+
258
+ - **Входы:** `elements` Цель
259
+ - **Выходы:** `boolean` Результат
260
+
261
+ ### Фокус — `dom.focus`
262
+
263
+ Переводит фокус клавиатуры на элемент.
264
+
265
+ - **Входы:** `exec`, `elements` Цель
266
+ - **Выходы:** `exec`
267
+
268
+ ### Прокрутить к — `dom.scrollIntoView`
269
+
270
+ Прокручивает страницу к элементу.
271
+
272
+ - **Входы:** `exec`, `elements` Цель, `boolean` Плавно = `true`
273
+ - **Выходы:** `exec`
274
+
275
+ ### Отправить событие — `dom.dispatch`
276
+
277
+ Отправляет своё событие от элементов (всплывает). Другие блюпринты ловят его блоком «Своё событие». Пустая цель — корень блюпринта.
278
+
279
+ - **Входы:** `exec`, `elements` Цель, `string` Имя события = `"my-event"`, `any` Данные
280
+ - **Выходы:** `exec`
281
+
282
+ ### Отменить действие браузера — `event.preventDefault`
283
+
284
+ Отменяет действие браузера по событию (переход по ссылке, отправку формы).
285
+
286
+ - **Входы:** `exec`, `event` Событие
287
+ - **Выходы:** `exec`
288
+
289
+ ### Цель события — `event.target`
290
+
291
+ Элемент, на котором событие произошло на самом деле (может быть потомком слушаемого).
292
+
293
+ - **Входы:** `event` Событие
294
+ - **Выходы:** `element` Цель
295
+
296
+ ## Данные
297
+
298
+ ### Текст — `data.string`
299
+
300
+ Текстовое значение.
301
+
302
+ - **Входы:** `string` Значение
303
+ - **Выходы:** `string` Значение
304
+
305
+ ### Число — `data.number`
306
+
307
+ Числовое значение.
308
+
309
+ - **Входы:** `number` Значение = `0`
310
+ - **Выходы:** `number` Значение
311
+
312
+ ### Да/нет — `data.boolean`
313
+
314
+ Логическое значение.
315
+
316
+ - **Входы:** `boolean` Значение = `false`
317
+ - **Выходы:** `boolean` Значение
318
+
319
+ ### Склеить текст — `string.concat`
320
+
321
+ Склеивает два текста с необязательным разделителем.
322
+
323
+ - **Входы:** `string` A, `string` B, `string` Разделитель
324
+ - **Выходы:** `string` Результат
325
+
326
+ ### В число — `convert.number`
327
+
328
+ Преобразует значение в число (0, если это не число).
329
+
330
+ - **Входы:** `any` Значение
331
+ - **Выходы:** `number` Число
332
+
333
+ ### В текст — `convert.string`
334
+
335
+ Преобразует значение в текст (объекты — в JSON).
336
+
337
+ - **Входы:** `any` Значение
338
+ - **Выходы:** `string` Текст
339
+
340
+ ### Прочитать из хранилища — `storage.get`
341
+
342
+ Значение, сохранённое в браузере (localStorage) под ключом; пусто, если нет.
343
+
344
+ - **Входы:** `string` Клавиша
345
+ - **Выходы:** `string` Значение
346
+
347
+ ### Сохранить в хранилище — `storage.set`
348
+
349
+ Сохраняет значение в браузере (localStorage); переживает перезагрузку.
350
+
351
+ - **Входы:** `exec`, `string` Клавиша, `string` Значение
352
+ - **Выходы:** `exec`
353
+
354
+ ### Объект (JSON) — `data.object`
355
+
356
+ Объект или массив в виде JSON — например настройки библиотеки: `{ "loop": true, "speed": 600 }`.
357
+
358
+ - **Входы:** —
359
+ - **Выходы:** `object` Объект
360
+ - **Настройки:** JSON (`json`)
361
+
362
+ ## Переменные
363
+
364
+ ### Прочитать переменную — `var.get`
365
+
366
+ Значение переменной блюпринта.
367
+
368
+ - **Входы:** —
369
+ - **Выходы:** `any` Значение
370
+ - **Настройки:** Переменная (`variable`)
371
+
372
+ ### Записать переменную — `var.set`
373
+
374
+ Сохраняет значение в переменную блюпринта (живёт, пока открыта страница).
375
+
376
+ - **Входы:** `exec`, `any` Значение
377
+ - **Выходы:** `exec`, `any` Значение
378
+ - **Настройки:** Переменная (`variable`)
379
+
380
+ ### Параметр компонента — `component.param`
381
+
382
+ Значение параметра компонента (задаётся в трейтах). Только для компонентных блюпринтов.
383
+
384
+ - **Входы:** —
385
+ - **Выходы:** `any` Значение
386
+ - **Настройки:** Параметр (`param`)
387
+
388
+ ## Математика
389
+
390
+ ### Математика — `math.op`
391
+
392
+ Арифметика двух чисел. Деление на ноль даёт 0.
393
+
394
+ - **Входы:** `number` A = `0`, `number` B = `0`
395
+ - **Выходы:** `number` Результат
396
+ - **Настройки:** Операция (`op` = `"+"`; `+` `-` `*` `/` `%` `min` `max` `pow`)
397
+
398
+ ## Логика
399
+
400
+ ### Сравнить — `logic.compare`
401
+
402
+ Сравнивает два значения. «==» сравнивает нестрого ("1" равно 1).
403
+
404
+ - **Входы:** `any` A, `any` B
405
+ - **Выходы:** `boolean` Результат
406
+ - **Настройки:** Оператор (`op` = `"=="`; `==` `!=` `<` `>` `<=` `>=`)
407
+
408
+ ### И — `logic.and`
409
+
410
+ Истина, если оба истинны.
411
+
412
+ - **Входы:** `boolean` A = `false`, `boolean` B = `false`
413
+ - **Выходы:** `boolean` Результат
414
+
415
+ ### ИЛИ — `logic.or`
416
+
417
+ Истина, если хотя бы одно истинно.
418
+
419
+ - **Входы:** `boolean` A = `false`, `boolean` B = `false`
420
+ - **Выходы:** `boolean` Результат
421
+
422
+ ### НЕ — `logic.not`
423
+
424
+ Инвертирует логическое значение.
425
+
426
+ - **Входы:** `boolean` Значение = `false`
427
+ - **Выходы:** `boolean` Результат
428
+
429
+ ## Код
430
+
431
+ ### JavaScript — `code.js`
432
+
433
+ Свой код. Входы — в `inputs`, верните объект с выходами (`return { result: 42 };`). В `ctx` есть `root`, `document`, `window`, `params`. С «Асинхронно» верните Promise: цепочка продолжится, когда он выполнится.
434
+
435
+ *пины зависят от настроек*
436
+
437
+ - **Входы:** `exec`, `any` value
438
+ - **Выходы:** `exec`, `any` result
439
+ - **Настройки:** Код (`code`), Входы (`inputs` = `[{"id":"value","type":"any"}]`), Выходы (`outputs` = `[{"id":"result","type":"any"}]`), Асинхронно (`async` = `false`)
440
+
441
+ ### Выражение — `code.expression`
442
+
443
+ JavaScript-выражение от `a` и `b`, например `a * 2 + b` или `a.trim()`.
444
+
445
+ - **Входы:** `any` a, `any` b
446
+ - **Выходы:** `any` Результат
447
+ - **Настройки:** Выражение (`expression`)
448
+
449
+ ### Вызвать функцию — `lib.call`
450
+
451
+ Вызывает глобальную функцию, например из библиотеки: `gsap.to`, `AOS.init`, `alert`. Аргументы передаются по порядку.
452
+
453
+ *пины зависят от настроек*
454
+
455
+ - **Входы:** `exec`, `any` Аргумент 1
456
+ - **Выходы:** `exec`, `any` Результат
457
+ - **Настройки:** Функция (`fn` = `"console.log"`), Аргументов (`args` = `1`)
458
+
459
+ ### Создать объект — `lib.new`
460
+
461
+ Создаёт объект класса библиотеки: `new Swiper(элемент, настройки)`, `new Chart(canvas, config)`.
462
+
463
+ *пины зависят от настроек*
464
+
465
+ - **Входы:** `exec`, `any` Аргумент 1, `any` Аргумент 2
466
+ - **Выходы:** `exec`, `object` Объект
467
+ - **Настройки:** Класс (`cls` = `"Swiper"`), Аргументов (`args` = `2`)
468
+
469
+ ### Вызвать метод — `lib.method`
470
+
471
+ Вызывает метод объекта, например `slideNext` у Swiper или `play` у видео.
472
+
473
+ *пины зависят от настроек*
474
+
475
+ - **Входы:** `exec`, `any` Объект
476
+ - **Выходы:** `exec`, `any` Результат
477
+ - **Настройки:** Метод (`method`), Аргументов (`args` = `0`)
478
+
479
+ ### Глобальное значение — `lib.get`
480
+
481
+ Читает глобальное значение: `location.pathname`, `innerWidth`, объект библиотеки.
482
+
483
+ - **Входы:** —
484
+ - **Выходы:** `any` Значение
485
+ - **Настройки:** Имя (`name` = `"location.pathname"`)
486
+
487
+ ## Отладка
488
+
489
+ ### Вывести в консоль — `debug.log`
490
+
491
+ Пишет значение в консоль браузера.
492
+
493
+ - **Входы:** `exec`, `string` Подпись, `any` Значение
494
+ - **Выходы:** `exec`
package/docs/schema.md ADDED
@@ -0,0 +1,64 @@
1
+ # Blueprint format
2
+
3
+ Blueprints are plain JSON, versioned by `schema`. The [JSON Schema](../schema/blueprint.schema.json) ships with the package:
4
+
5
+ ```js
6
+ import schema from 'blueprintsjs/schema.json' with { type: 'json' };
7
+ ```
8
+
9
+ | Field | Type | |
10
+ |---|---|---|
11
+ | `schema` | number | Format version (`SCHEMA_VERSION`, now `1`). |
12
+ | `id` | string | Unique id (`bp_…`). |
13
+ | `name`, `description` | string | |
14
+ | `kind` | `"global"` \| `"template"` \| `"component"` | See the [guide](guide.md#kinds). |
15
+ | `enabled` | boolean | Disabled blueprints are left out of `buildScript`. |
16
+ | `target` | `{ pages?: string[], when?: string }` | Template blueprints: host pages and the runtime CSS condition. |
17
+ | `component` | `{ type, label?, html?, css?, params? }` | Component blueprints. |
18
+ | `libraries` | string[] | Ids of libraries the blueprint needs (for the host). |
19
+ | `variables` | `{ id, name, type, default? }[]` | |
20
+ | `nodes` | `{ id, type, pos: [x, y], props?, disabled?, collapsed? }[]` | |
21
+ | `links` | `{ from: [node, pin], to: [node, pin] }[]` | From an output to an input. |
22
+ | `comments` | `{ id, text, pos, size, color? }[]` | Comment boxes in the editor. |
23
+ | `editor` | `{ pan?: [x, y], zoom? }` | Viewport saved by the editor. |
24
+
25
+ Store a list of them however you like. `grapesjs-scripts`, for example, keeps them in the GrapesJS project data together with its own settings.
26
+
27
+ ## The popup blueprint
28
+
29
+ ```json
30
+ {
31
+ "schema": 1,
32
+ "id": "bp_popup",
33
+ "name": "Popup",
34
+ "kind": "global",
35
+ "enabled": true,
36
+ "variables": [],
37
+ "nodes": [
38
+ { "id": "open", "type": "event.element", "pos": [40, 40], "props": { "selector": ".js-popup-open", "event": "click" } },
39
+ { "id": "show", "type": "dom.addClass", "pos": [360, 40], "props": { "target": "#popup", "className": "is-open" } },
40
+ { "id": "close", "type": "event.element", "pos": [40, 240], "props": { "selector": ".js-popup-close", "event": "click" } },
41
+ { "id": "hide", "type": "dom.removeClass", "pos": [360, 240], "props": { "target": "#popup", "className": "is-open" } }
42
+ ],
43
+ "links": [
44
+ { "from": ["open", "then"], "to": ["show", "exec"] },
45
+ { "from": ["close", "then"], "to": ["hide", "exec"] }
46
+ ]
47
+ }
48
+ ```
49
+
50
+ - `props` holds the block settings and the values typed into unconnected inputs (`target`, `className` above).
51
+ - `links` go from an output `[node, pin]` to an input `[node, pin]`.
52
+ - Loading normalizes the data: unknown kinds become `global`, wires to missing nodes are dropped, positions become numbers. Migrations from older schemas will live in `normalizeBlueprint`, so always load stored data through it.
53
+
54
+ ## What it compiles to
55
+
56
+ ```js
57
+ // open · On element event
58
+ __bp_delegate(__d, root, "click", ".js-popup-open", function (event, self) {
59
+ // show · Add class
60
+ __bp_q(root, "#popup").forEach(function (el) { el.classList.add("is-open"); });
61
+ });
62
+ ```
63
+
64
+ The page script is one IIFE: the blueprints first, then only the runtime helpers they use; it starts on `DOMContentLoaded`. Each blueprint returns a function that removes its listeners and timers (used by the preview).
@@ -0,0 +1,110 @@
1
+ <!doctype html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="utf-8" />
5
+ <title>blueprintsjs — popup demo</title>
6
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
7
+ <style>
8
+ body { font: 15px/1.5 system-ui, sans-serif; margin: 0; padding: 24px; color: #222; }
9
+ .bar { display: flex; gap: 8px; align-items: center; flex-wrap: wrap; margin-bottom: 16px; }
10
+ .bar button, .bar select { font: inherit; padding: 6px 12px; }
11
+ #status { color: #666; }
12
+ #popup { display: none; position: fixed; inset: 0; background: rgba(0, 0, 0, .45); align-items: center; justify-content: center; }
13
+ #popup.is-open { display: flex; }
14
+ #popup .box { background: #fff; padding: 24px 28px; border-radius: 10px; min-width: 260px; }
15
+ #panel { position: relative; height: 480px; border: 1px solid #ccc; margin-top: 16px; display: none; }
16
+ #panel.on { display: block; }
17
+ pre { background: #f6f7f9; padding: 12px; overflow: auto; max-height: 360px; font-size: 12px; }
18
+ </style>
19
+ </head>
20
+ <body>
21
+ <h1>blueprintsjs demo</h1>
22
+ <div class="bar">
23
+ <button id="edit">Edit blueprint</button>
24
+ <button id="edit-panel">Edit in a panel</button>
25
+ <button id="run">Run</button>
26
+ <label>Editor language
27
+ <select id="lang"><option value="">English</option><option value="ru">Русский</option><option value="uk">Українська</option></select>
28
+ </label>
29
+ <span id="status"></span>
30
+ </div>
31
+
32
+ <p>The page below is controlled by the blueprint. Press <b>Run</b>, then try the button.</p>
33
+ <button class="js-popup-open">Open the popup</button>
34
+ <div id="popup"><div class="box"><p>Hello from a blueprint!</p><button class="js-popup-close">Close</button></div></div>
35
+
36
+ <div id="panel"></div>
37
+ <h3>Generated JavaScript</h3>
38
+ <pre id="code"></pre>
39
+
40
+ <script src="../dist/blueprintsjs.umd.cjs"></script>
41
+ <script>
42
+ const { createRegistry, createBlueprint, normalizeBlueprint, buildScript, GraphEditor, createText, locales } = window.Blueprints;
43
+
44
+ const registry = createRegistry();
45
+ const KEY = 'blueprintsjs-demo';
46
+ let bp;
47
+ try { bp = JSON.parse(localStorage.getItem(KEY) || 'null'); } catch (e) { bp = null; }
48
+ bp = bp ? normalizeBlueprint(bp) : createBlueprint({
49
+ name: 'Popup',
50
+ kind: 'global',
51
+ nodes: [
52
+ { id: 'open', type: 'event.element', pos: [40, 40], props: { selector: '.js-popup-open', event: 'click' } },
53
+ { id: 'show', type: 'dom.addClass', pos: [360, 40], props: { target: '#popup', className: 'is-open' } },
54
+ { id: 'close', type: 'event.element', pos: [40, 240], props: { selector: '.js-popup-close', event: 'click' } },
55
+ { id: 'hide', type: 'dom.removeClass', pos: [360, 240], props: { target: '#popup', className: 'is-open' } },
56
+ ],
57
+ links: [
58
+ { from: ['open', 'then'], to: ['show', 'exec'] },
59
+ { from: ['close', 'then'], to: ['hide', 'exec'] },
60
+ ],
61
+ });
62
+
63
+ const $ = (id) => document.getElementById(id);
64
+ let dispose = null;
65
+
66
+ function save(next) {
67
+ bp = next;
68
+ try { localStorage.setItem(KEY, JSON.stringify(bp)); } catch (e) {}
69
+ render();
70
+ if (dispose) { stop(); run(); } // live reload
71
+ }
72
+ function render() {
73
+ const res = buildScript([bp], registry);
74
+ $('code').textContent = res.code;
75
+ const errors = res.diagnostics.filter((d) => d.severity === 'error').length;
76
+ $('status').textContent = (dispose ? 'Running. ' : 'Stopped. ') + (errors ? errors + ' error(s)' : 'No errors');
77
+ }
78
+ function run() {
79
+ const start = (0, eval)(buildScript([bp], registry, { target: 'preview' }).code);
80
+ dispose = start(document);
81
+ $('run').textContent = 'Stop';
82
+ render();
83
+ }
84
+ function stop() {
85
+ if (dispose) dispose();
86
+ dispose = null;
87
+ $('popup').classList.remove('is-open');
88
+ $('run').textContent = 'Run';
89
+ render();
90
+ }
91
+ function edit(parent) {
92
+ const lang = $('lang').value;
93
+ if (parent) parent.classList.add('on');
94
+ new GraphEditor({
95
+ blueprint: bp,
96
+ registry,
97
+ t: createText(locales[lang]),
98
+ embedded: !!parent,
99
+ onChange: save,
100
+ onClose: (b) => { save(b); if (parent) parent.classList.remove('on'); },
101
+ }).mount(parent || document.body);
102
+ }
103
+
104
+ $('run').onclick = () => (dispose ? stop() : run());
105
+ $('edit').onclick = () => edit();
106
+ $('edit-panel').onclick = () => edit($('panel'));
107
+ render();
108
+ </script>
109
+ </body>
110
+ </html>