@vnejs/docs 0.2.39 → 0.2.41

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 (7) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/package.json +1 -1
  3. package/plugins/scenario/point_and_click.md +8 -6
  4. package/plugins/views.scenario/point_and_click.md +10 -10
  5. package/scenario.catalog/stubs/point-and-click.block.md +3 -1
  6. package/scenario.catalog/stubs/point-and-click.option.md +7 -3
  7. package/scenario.guide/point-and-click.md +13 -9
package/CHANGELOG.md CHANGED
@@ -2,6 +2,14 @@
2
2
 
3
3
  Краткая история изменений движка (плагины, helpers, packages, CLI и прочий runtime) и внешнего API. Версии — релизы пакета `@vnejs/docs`.
4
4
 
5
+ ## 0.2.40
6
+
7
+ - `cli/tools` resize image/video — снова генерирует `360p` при target `all` / `mobile` / `360` (как в старом image/video.js); дополнительно `90p` только при target `all` / `90`.
8
+ - `uis.react` Cursor — дефолтный `size` 180 (было 120); дефолтный `transition` 300 (было 500).
9
+ - `scenario/point_and_click` — `% point-and-click.option {icon} {iconHover} x y` (hover-иконка обязательна); опционально args `imgWidth` / `imgHeight` (px canvas). API: `PointAndClickOption.iconHover`, `imgWidth`, `imgHeight`.
10
+ - `views.scenario/point_and_click` — загрузка `iconHoverSrc`; hover swap на hotspot; размер через `imgWidth` / `imgHeight`; `PARAMS.POINT_AND_CLICK_VIEW.TRANSITION` (300) → `Image.transition` для анимации hover.
11
+ - `uis.react` Image — prop `srcHover` (CSS swap на `[vne-cursor-target]`, как у Icon).
12
+
5
13
  ## 0.2.39
6
14
 
7
15
  - `game/checkers` — пресеты `FLIPPED` (белые сверху / чёрные снизу, все дамки) и `RANDOM` (12+12 на случайных тёмных клетках; на каждый `SHOW` новый расклад). API: `PARAMS.CHECKERS.PRESETS.FLIPPED` / `RANDOM`, `createFlippedPreset`, `createRandomPreset`.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vnejs/docs",
3
- "version": "0.2.39",
3
+ "version": "0.2.41",
4
4
  "description": "VNEJS documentation for engine consumers and coding agents",
5
5
  "files": [
6
6
  "*.md",
package/plugins/scenario/point_and_click.md CHANGED
@@ -6,17 +6,19 @@
6
6
 
7
7
  ## Сценарные команды
8
8
 
9
- | Синтаксис | Смысл |
10
- | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
11
- | `% point-and-click` | Открыть point-and-click: собрать `% point-and-click.option`, emit `EMIT`. Если все опции `hided` (или список пуст) — `SKIP` и переход за блок. |
12
- | `% point-and-click.option {icon} x y` | Hotspot; при проходе мимо невыбранного — skip тела по indent. |
13
- | `$ point-and-click repeat` | Вернуться к ближайшему `% point-and-click` **выше** текущей строки в том же label и `emitNext`. |
9
+ | Синтаксис | Смысл |
10
+ | ------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
11
+ | `% point-and-click` | Открыть point-and-click: собрать `% point-and-click.option`, emit `EMIT`. Если все опции `hided` (или список пуст) — `SKIP` и переход за блок. |
12
+ | `% point-and-click.option {icon} {iconHover} x y` | Hotspot; при проходе мимо невыбранного — skip тела по indent. Опционально args `imgWidth` / `imgHeight` (px canvas). |
13
+ | `$ point-and-click repeat` | Вернуться к ближайшему `% point-and-click` **выше** текущей строки в том же label и `emitNext`. |
14
14
 
15
15
  Пример цикла осмотра:
16
16
 
17
17
  ```vne
18
18
  % point-and-click
19
- % point-and-click.option {lupa} 25 25
19
+ % point-and-click.option {search} {search-hover} 25 25
20
+ imgWidth: 60
21
+ imgHeight: 60
20
22
  hided: $ flag prologue_2_pac_1
21
23
  $ flag prologue_2_pac_1
22
24
  "…"
package/plugins/views.scenario/point_and_click.md CHANGED
@@ -21,11 +21,11 @@ React-UI point-and-click (иконки-hotspot). Зависит от scenario-п
21
21
 
22
22
  ## Параметры
23
23
 
24
- | Ключ | Тип | Смысл |
25
- | --------------------- | -------- | ------------------------------------------ |
26
- | `TRANSITION` | `number` | Длительность анимации показа/скрытия (мс). |
27
- | `ZINDEX` | `number` | Z-index слоя и индекс блока controls. |
28
- | `CONTROLS_EXTENSIONS` | `object` | Дополнительные обработчики controls. |
24
+ | Ключ | Тип | Смысл |
25
+ | --------------------- | -------- | ---------------------------------------------------------------------------------------------- |
26
+ | `TRANSITION` | `number` | Длительность анимации показа/скрытия Screen и swap hotspot-картинки на hover (мс); дефолт 300. |
27
+ | `ZINDEX` | `number` | Z-index слоя и индекс блока controls. |
28
+ | `CONTROLS_EXTENSIONS` | `object` | Дополнительные обработчики controls. |
29
29
 
30
30
  ## Настройки
31
31
 
@@ -33,11 +33,11 @@ React-UI point-and-click (иконки-hotspot). Зависит от scenario-п
33
33
 
34
34
  ## Модули
35
35
 
36
- | Модуль | Зона ответственности |
37
- | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
38
- | `point_and_click_view.bridge` | Bridge `POINT_AND_CLICK.SHOW/HIDE` → `POINT_AND_CLICK_VIEW.SHOW/HIDE`; на hide — `INTERFACE.TEXT_HIDE`. |
39
- | `point_and_click_view.controller` | Загрузка `iconSrc`, `controls` из `CONTROLS_EXTENSIONS` в `init`, `beforeShow` / `afterHide`. `SETTINGS.CHANGED` → `updateViewFast` только при `state.isShow`. |
40
- | `point_and_click_view.view` | React-render hotspot-иконок. |
36
+ | Модуль | Зона ответственности |
37
+ | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
38
+ | `point_and_click_view.bridge` | Bridge `POINT_AND_CLICK.SHOW/HIDE` → `POINT_AND_CLICK_VIEW.SHOW/HIDE`; на hide — `INTERFACE.TEXT_HIDE`. |
39
+ | `point_and_click_view.controller` | Загрузка `iconSrc` / `iconHoverSrc`, `controls` из `CONTROLS_EXTENSIONS` в `init`, `beforeShow` / `afterHide`. `SETTINGS.CHANGED` → `updateViewFast` только при `state.isShow`. |
40
+ | `point_and_click_view.view` | React-render hotspot-иконок (`Image` + `srcHover` + `transition` из `PARAMS.POINT_AND_CLICK_VIEW.TRANSITION`; размер — натуральный или args `imgWidth` / `imgHeight` в px canvas). |
41
41
 
42
42
  ## Связь с POINT_AND_CLICK
43
43
 
package/scenario.catalog/stubs/point-and-click.block.md CHANGED
@@ -10,7 +10,9 @@
10
10
 
11
11
  ```vne
12
12
  % point-and-click
13
- % point-and-click.option {lupa} 25 25
13
+ % point-and-click.option {search} {search-hover} 25 25
14
+ imgWidth: 60
15
+ imgHeight: 60
14
16
  hided: $ flag pac_1
15
17
  $ flag pac_1
16
18
  $ point-and-click repeat
package/scenario.catalog/stubs/point-and-click.option.md CHANGED
@@ -3,15 +3,19 @@
3
3
  | | |
4
4
  | ---------- | ------------------------------------------------------------------------ |
5
5
  | Тип | `block` (`%`) |
6
- | Сигнатура | `% point-and-click.option {icon} x y` |
6
+ | Сигнатура | `% point-and-click.option {icon} {iconHover} x y` |
7
7
  | Plugin doc | [scenario/point_and_click.md](../../plugins/scenario/point_and_click.md) |
8
8
 
9
9
  ## Примеры
10
10
 
11
11
  ```vne
12
- % point-and-click.option {lupa} 25 25
12
+ % point-and-click.option {search} {search-hover} 25 25
13
+ imgWidth: 60
14
+ imgHeight: 60
13
15
  "…"
14
- % point-and-click.option {pencil} 50 50
16
+ % point-and-click.option {search} {search-hover} 50 50
17
+ imgWidth: 60
18
+ imgHeight: 60
15
19
  hided: $ flag done
16
20
  ```
17
21
 
package/scenario.guide/point-and-click.md CHANGED
@@ -4,12 +4,16 @@ Hotspot-выбор на фоне. UI — view-плагин; ветки — ка
4
4
 
5
5
  ```vne
6
6
  % point-and-click
7
- % point-and-click.option {lupa} 25 25
7
+ % point-and-click.option {search} {search-hover} 25 25
8
+ imgWidth: 60
9
+ imgHeight: 60
8
10
  hided: $ flag pac_1
9
11
  $ flag pac_1
10
12
  "Нашли предмет."
11
13
  $ point-and-click repeat
12
- % point-and-click.option {pencil} 50 50
14
+ % point-and-click.option {search} {search-hover} 50 50
15
+ imgWidth: 60
16
+ imgHeight: 60
13
17
  hided: $ flag pac_2
14
18
  $ flag pac_2
15
19
  "Другая точка."
@@ -19,15 +23,15 @@ Hotspot-выбор на фоне. UI — view-плагин; ветки — ка
19
23
 
20
24
  ## Команды
21
25
 
22
- | Синтаксис | Смысл |
23
- | ------------------------------------- | ----------------------------------------------- |
24
- | `% point-and-click` | Открыть режим; собрать `.option` |
25
- | `% point-and-click.option {icon} x y` | Hotspot: иконка + координаты |
26
- | `$ point-and-click repeat` | Вернуться к ближайшему `% point-and-click` выше |
26
+ | Синтаксис | Смысл |
27
+ | ------------------------------------------------- | ----------------------------------------------- |
28
+ | `% point-and-click` | Открыть режим; собрать `.option` |
29
+ | `% point-and-click.option {icon} {iconHover} x y` | Hotspot: иконка, hover-иконка и координаты |
30
+ | `$ point-and-click repeat` | Вернуться к ближайшему `% point-and-click` выше |
27
31
 
28
- `x` / `y` — числа (проценты/координаты UI — по конвенции игры). `{icon}` — id иконки из медиа.
32
+ `x` / `y` — числа (проценты/координаты UI — по конвенции игры). `{icon}` / `{iconHover}` — id иконок из `media/icons/.../point_and_click/`.
29
33
 
30
- Props `hided:` / `disabled:` — как у choose.
34
+ Props `hided:` / `disabled:` — как у choose. Опционально `imgWidth:` / `imgHeight:` — размер hotspot в пикселях canvas.
31
35
 
32
36
  ## См. также
33
37