slidev-theme-practicum 0.1.0 → 0.1.2

package/example.md

@@ -1,6 +1,8 @@
 ---
 theme: ./
 title: Яндекс Практикум — справочная галерея
+routerMode: hash
+preload: false
 layout: cover
 variant: grid
 mode: dark
@@ -237,6 +239,7 @@ decor:
 ---
 layout: explainer
 variant: title-supports
+preload: false
 ---
 
 # Сначала задача, потом макет
@@ -260,6 +263,12 @@ layout: explainer
 variant: title-supports
 ---
 
+<!--
+Контракт explainer:title-supports:
+- 1× заголовок `# …`
+- 3+ пункта `-` верхнего уровня (поддержки справа)
+-->
+
 # Заголовок и три коротких аргумента
 
 - Самая рабочая лошадка: одна мысль слева и три аргумента справа.
@@ -271,6 +280,13 @@ layout: explainer
 variant: title-supports-bottom-muted
 ---
 
+<!--
+Контракт explainer:title-supports-bottom-muted:
+- 1× заголовок `# …`
+- ровно 2 пункта `-` верхнего уровня (нижний 50/50)
+- без абзацев и без 3+ пунктов
+-->
+
 # Заголовок и две приглушённые опоры
 
 - Контекст или ограничение: «учитывайте, что» или «работает, если».
@@ -281,9 +297,18 @@ layout: explainer
 variant: title-supports-bottom-plain
 ---
 
+<!--
+Контракт explainer:title-supports-bottom-plain:
+- 1× заголовок `# …`
+- ровно 2 пункта `-` верхнего уровня (без приглушения нижних опор)
+-->
+
 # Когда нужны два самостоятельных абзаца
 
 - Этот вариант снимает приглушение с нижних опор. Каждый абзац читается как самостоятельный текст: его не воспринимают как «второстепенный к заголовку», а ставят рядом по весу.
+  - авава
+  - ава
+  авава
 - Берите слайд, когда тезис распадается на два независимых направления: например, «что включить» и «чего избегать», «теория» и «практика», «причина» и «следствие». Третий блок не нужен — два аргумента уже задают сильную смысловую пару.
 
 ---
@@ -303,8 +328,15 @@ variant: title-body
 layout: message
 variant: centered
 mode: light
+preload: false
 ---
 
+<!--
+Контракт message:centered:
+- только 1× заголовок `# …`
+- без абзацев, списков и blockquote в теле слайда
+-->
+
 # Поставьте паузу: оставьте на слайде один тезис
 
 ---
@@ -314,9 +346,9 @@ mode: light
 person:
   name: Константин Константинопольский
   title: наставник
-  avatar: /photos/photo-3.png
-  avatar-position: '50% 38%'
-  avatar-zoom: 1.04
+  avatar: /theme/photos/photo-30.webp
+  avatar-position: '62% 42%'
+  avatar-zoom: 1.18
 ---
 
 > Цитата работает, когда внешний голос усиливает тезис.
@@ -377,6 +409,7 @@ layout: collection
 variant: points
 arrangement: trio
 tone: green
+preload: false
 decor:
   meaning: rules
   tone: green
@@ -446,7 +479,7 @@ decor:
   id: decor-rules-wide-01
   opacity: 0.85
 media:
-  src: /photos/photo-5.png
+  src: /theme/photos/photo-5.webp
   fit: cover
   position: '48% 44%'
   zoom: 1.08
@@ -465,7 +498,7 @@ layout: collection
 variant: metrics
 arrangement: featured-copy
 media:
-  src: /photos/photo-5.png
+  src: /theme/photos/photo-5.webp
   fit: cover
   position: '48% 44%'
   zoom: 1.08
@@ -484,11 +517,11 @@ layout: collection
 variant: metrics
 arrangement: featured-copy-split-media
 media:
-  - src: /photos/photo-5.png
+  - src: /theme/photos/photo-5.webp
     fit: cover
     position: '48% 44%'
     zoom: 1.08
-  - src: /photos/photo-6.png
+  - src: /theme/photos/photo-6.webp
     fit: cover
     position: '50% 40%'
     zoom: 1.04
@@ -507,6 +540,14 @@ variant: facts-stacked
 mode: dark
 ---
 
+<!--
+Контракт collection:facts-stacked:
+- 1× заголовок `# …`
+- опционально 1 абзац между заголовком и списком
+- ровно 3 факта: у каждого `- значение` и вложенный `  - подпись`
+- не используйте `- роль: текст` в одной строке
+-->
+
 # Три факта как вертикальная опора
 
 Когда нужно отступить от равных карточек, этот архетип собирает заголовок и три факта без ручных координат.
@@ -518,6 +559,28 @@ mode: dark
 - иногда
   - факты могут быть короткими словами
 
+---
+layout: collection
+variant: facts-duo
+mode: light
+tone: blue
+---
+
+<!--
+Контракт collection:facts-duo:
+- 1× заголовок `# …`, опционально абзац до списка
+- ровно 2 факта с вложенной подписью (`  - …`)
+-->
+
+# Два факта как развилка выбора
+
+Берите этот вариант, когда нужно поставить рядом два равных результата без ручной сетки.
+
+- быстрее
+  - сокращает ожидание обратной связи
+- надёжнее
+  - оставляет проверяемый след решения
+
 ---
 layout: collection
 variant: facts-trio
@@ -525,6 +588,12 @@ mode: light
 tone: blue
 ---
 
+<!--
+Контракт collection:facts-trio:
+- 1× заголовок `# …`, опционально абзац до списка
+- ровно 3 факта с вложенной подписью
+-->
+
 # Заголовок поддержанный тремя одноранговыми фактами
 
 Берите этот вариант, когда тезис подкрепляется тремя сопоставимыми числами и важна равная значимость
@@ -536,6 +605,32 @@ tone: blue
 - иногда
   - факты могут быть короткими словами
 
+---
+layout: collection
+variant: facts-quartet
+mode: light
+tone: blue
+---
+
+<!--
+Контракт collection:facts-quartet:
+- 1× заголовок `# …`, опционально абзац до списка
+- ровно 4 факта с вложенной подписью
+-->
+
+# Четыре факта в одной нижней полосе
+
+Берите этот вариант, когда тезис держится на четырёх коротких, сопоставимых опорах.
+
+- X
+  - повторяемая операция
+- Y
+  - проверяемый артефакт
+- Z
+  - критерий качества
+- W
+  - условие остановки
+
 ---
 layout: collection
 variant: facts-featured
@@ -570,12 +665,13 @@ mode: light
 layout: none
 mode: light
 header: default
+preload: false
 ---
 
 <Slot area="2 / 1 / 6 / -1" gap="2">
   <Text size="6">Акцентный цвет — пять настроений</Text>
   <Text size="3" muted>
-    Цвета фона и акцента работают независимо: можно держать графитовый фон с синими акцентами или красить весь слайд в выбранный цвет.
+    Цвета фона и акцента работают **независимо**: можно держать графитовый фон с синими акцентами или красить весь слайд в выбранный цвет.
   </Text>
 </Slot>
 
@@ -767,7 +863,7 @@ header: default
 </Slot>
 
 <Slot area="7 / 7 / -1 / 10" surface="light">
-  <Image src="/photos/photo-5.png" fit="cover" position="52% 40%" zoom="1.08" />
+  <Image src="/theme/photos/photo-5.webp" fit="cover" position="52% 40%" zoom="1.08" />
 </Slot>
 
 <Slot area="7 / 10 / -1 / -1" surface="color" tone="blue" margin="3" gap="2">
@@ -781,6 +877,32 @@ variant: closing
 mode: dark
 tone: blue
 logo: full
+preload: false
 ---
 
-# Делайте меньше, но точнее
+<!--
+Контракт message:closing:
+- обязательно 1× заголовок `# …`
+- можно добавить не более 1× абзаца под заголовком
+-->
+
+# Делайте меньше, но точнее…
+
+---
+layout: message
+variant: closing
+mode: dark
+tone: blue
+logo: full
+preload: false
+---
+
+<!--
+Контракт message:closing:
+- обязательно 1× заголовок `# …`
+- можно добавить не более 1× абзаца под заголовком
+-->
+
+# Делайте меньше, но точнее…
+
+Оставьте только то, что ведёт к следующему действию

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "slidev-theme-practicum",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Strict Slidev presentation theme with a 12x12 grid, editorial layouts, and low-level slot composition API",
   "keywords": [
     "slidev-theme",
@@ -18,23 +18,24 @@
   "files": [
     "components",
     "composables",
+    "scripts",
     "layouts",
     "public",
     "setup",
     "styles",
     "types",
-    "decor-library.md",
-    "env.d.ts",
+    "skills",
+    "LICENSE",
+    "README.md",
     "example.md",
-    "slidev-theme-practicum.png",
-    "slidev-theme-practicum.svg"
+    "decor-library.md"
   ],
   "slidev": {
     "colorSchema": "light",
     "defaults": {
       "aspectRatio": "16/9",
       "canvasWidth": 1920,
-      "favicon": "/favicon.svg",
+      "favicon": "/theme/favicon.svg",
       "fonts": {
         "provider": "none",
         "sans": "YS Text, Inter",
@@ -47,8 +48,12 @@
     }
   },
   "engines": {
+    "node": "^20.19.0 || >=22.12.0",
     "slidev": ">=0.50.0"
   },
+  "bin": {
+    "slidev-practicum-validate": "scripts/validate-deck.cjs"
+  },
   "scripts": {
     "dev": "slidev example.md",
     "dev:decor": "slidev decor-library.md",
@@ -58,26 +63,35 @@
     "screenshot": "slidev export example.md --format png",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
-    "test": "npm run typecheck && npm run test:unit && npm run test:build",
+    "validate-deck": "node scripts/validate-deck.cjs",
+    "test": "npm run lint && npm run typecheck && npm run test:unit && npm run test:architecture && npm run test:build && npm run test:build-artifact && npm run test:browser && npm run test:package",
     "typecheck": "vue-tsc --noEmit",
+    "test:architecture": "node scripts/check-test-architecture.mjs",
     "test:unit": "node --test tests/*.test.cjs",
-    "test:build": "slidev build example.md"
+    "test:validate-deck": "node scripts/validate-deck.cjs example.md",
+    "test:build": "slidev build example.md",
+    "test:build-artifact": "node scripts/check-build-artifact.mjs",
+    "test:browser": "node scripts/browser-smoke.mjs",
+    "test:package": "node scripts/check-package.mjs"
   },
   "author": "",
   "type": "commonjs",
   "dependencies": {
-    "@slidev/types": "^52.14.2"
+    "@slidev/parser": "^52.14.2",
+    "@slidev/types": "^52.14.2",
+    "markdown-it": "^14.1.0",
+    "typescript": "^6.0.3",
+    "vue": "^3.5.13"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@slidev/cli": "^52.14.2",
-    "@slidev/parser": "^52.14.2",
     "@stylistic/eslint-plugin": "^5.10.0",
     "eslint": "^10.2.0",
     "eslint-plugin-vue": "^10.8.0",
     "globals": "^17.5.0",
     "playwright-chromium": "^1.59.1",
-    "typescript": "^6.0.3",
+    "postcss": "^8.5.9",
     "typescript-eslint": "^8.58.2",
     "vue-tsc": "^3.2.7"
   }