docs(samples): add visual walkthroughs and a sidebar-driven website

.claude/launch.json

@@ -0,0 +1,59 @@
+{
+  "version": "0.0.1",
+  "configurations": [
+    {
+      "name": "website-ru-3001",
+      "runtimeExecutable": "npx",
+      "runtimeArgs": [
+        "docusaurus",
+        "start",
+        "--locale",
+        "ru",
+        "--port",
+        "3001",
+        "--no-open"
+      ],
+      "cwd": "Website",
+      "port": 3001
+    },
+    {
+      "name": "website-dev",
+      "runtimeExecutable": "npx",
+      "runtimeArgs": [
+        "docusaurus",
+        "start",
+        "--port",
+        "3100",
+        "--no-open"
+      ],
+      "cwd": "Website",
+      "port": 3100
+    },
+    {
+      "name": "website-dev-ru",
+      "runtimeExecutable": "npx",
+      "runtimeArgs": [
+        "docusaurus",
+        "start",
+        "--locale",
+        "ru",
+        "--port",
+        "3101",
+        "--no-open"
+      ],
+      "cwd": "Website",
+      "port": 3101
+    },
+    {
+      "name": "website-serve-all",
+      "runtimeExecutable": "sh",
+      "runtimeArgs": [
+        "-c",
+        "npm run build && npx docusaurus serve --port 3001 --no-open"
+      ],
+      "cwd": "Website",
+      "_note": "Only when Website/scripts/serve-all.sh is unusable: this ties the shared 3001 server to one session.",
+      "port": 3001
+    }
+  ]
+}

.github/workflows/docs.yml

@@ -1,25 +1,25 @@
 name: Docs
 
 # Builds the Docusaurus site in Website/ and publishes it to GitHub Pages.
-# Content comes from the package (Documentation/ and Samples~/*/README*.md, TUTORIAL*.md) and the root CHANGELOG*.md,
+# Content comes from the package (Documentation/ and Samples~/*/Documentation/) and the root CHANGELOG*.md,
 # so any change there rebuilds the site.
 
 on:
   push:
     branches: [main]
     paths:
       - 'Website/**'
+      - 'README.md'
       - 'Aspid.FastTools/Packages/tech.aspid.fasttools/Documentation/**'
-      - 'Aspid.FastTools/Packages/tech.aspid.fasttools/Samples~/*/README*.md'
-      - 'Aspid.FastTools/Packages/tech.aspid.fasttools/Samples~/*/TUTORIAL*.md'
+      - 'Aspid.FastTools/Packages/tech.aspid.fasttools/Samples~/*/Documentation/**'
       - 'CHANGELOG*.md'
       - '.github/workflows/docs.yml'
   pull_request:
     paths:
       - 'Website/**'
+      - 'README.md'
       - 'Aspid.FastTools/Packages/tech.aspid.fasttools/Documentation/**'
-      - 'Aspid.FastTools/Packages/tech.aspid.fasttools/Samples~/*/README*.md'
-      - 'Aspid.FastTools/Packages/tech.aspid.fasttools/Samples~/*/TUTORIAL*.md'
+      - 'Aspid.FastTools/Packages/tech.aspid.fasttools/Samples~/*/Documentation/**'
       - 'CHANGELOG*.md'
       - '.github/workflows/docs.yml'
   workflow_dispatch:
@@ -45,6 +45,8 @@ jobs:
           cache-dependency-path: Website/package-lock.json
       - run: npm ci
         working-directory: Website
+      - run: npm run check-readme
+        working-directory: Website
       - run: npm run build
         working-directory: Website
       - uses: actions/upload-pages-artifact@v3

.github/workflows/release.yml

@@ -84,6 +84,18 @@ jobs:
           fi
           echo "package.json version matches: $PKG_VERSION"
 
+      - name: Validate documentation version
+        run: |
+          set -euo pipefail
+          VERSION="${{ steps.version.outputs.version }}"
+          for f in README.md "$PACKAGE_PATH/Documentation/README.md" "$PACKAGE_PATH/Documentation/ru/README.md" \
+                   "$PACKAGE_PATH/Documentation/Images/status-badge-preview.svg"; do
+            if ! grep -qF "$VERSION" "$f"; then
+              echo "::error file=$f::$f does not mention $VERSION. Run scripts/set-version.sh $VERSION."
+              exit 1
+            fi
+          done
+
       - name: Extract CHANGELOG section
         id: changelog
         run: |

CLAUDE.md → AGENTS.md

@@ -12,4 +12,6 @@ Unity package `tech.aspid.fasttools` (`Aspid.FastTools/Packages/tech.aspid.fastt
 ## Not obvious
 
 - A change to generator or analyzer source reaches Unity **only** after `dotnet build -c Release` in that solution;
-  `dotnet test` (Debug) deliberately does not copy the DLL, so it is safe to run.
+  `dotnet test` (Debug) deliberately does not copy the DLL, so it is safe to run.
+- The version lives in `package.json`, the badge SVG and the install URLs of both READMEs; bump all of them with
+  `scripts/set-version.sh <version>`, which the release workflow checks.

Aspid.FastTools/Assets/DevTests/Enums/Scripts/EnumValuesIMGUITest.cs

@@ -51,5 +51,11 @@ public struct Profile
 
         // [Flags] key handling.
         [SerializeField] private EnumValues<Modifier, float> _typedFlags;
+
+        // Object-reference values: the row draws an object field rather than a plain value or a foldout.
+        [SerializeField] private EnumValues<Element, AudioClip> _typedObjectValues;
+
+        // Tables inside a collection: the drawer is applied per element, one table per array entry.
+        [SerializeField] private EnumValues<Element, Color>[] _typedArray;
     }
 }

Aspid.FastTools/Assets/DevTests/Enums/Scripts/EnumValuesUIToolkitTest.cs

@@ -16,5 +16,9 @@ public sealed class EnumValuesUIToolkitTest : MonoBehaviour
         [SerializeField] private EnumValues<EnumValuesIMGUITest.Element, EnumValuesIMGUITest.Profile> _typedFoldout;
 
         [SerializeField] private EnumValues<EnumValuesIMGUITest.Modifier, float> _typedFlags;
+
+        [SerializeField] private EnumValues<EnumValuesIMGUITest.Element, AudioClip> _typedObjectValues;
+
+        [SerializeField] private EnumValues<EnumValuesIMGUITest.Element, Color>[] _typedArray;
     }
 }

Aspid.FastTools/Assets/DevTests/README.md

@@ -0,0 +1,51 @@
+# DevTests
+
+Manual harnesses for `tech.aspid.fasttools`, kept in the development project only: nothing here is part
+of the package or of its samples, and nothing here ships to users.
+
+The package's own `Tests/Editor` assembly covers the logic, and `Samples~` covers the ordinary,
+user-facing flows in UI Toolkit. What is left for this folder is what neither can do: render a drawer
+through the IMGUI path, and hold assets that are deliberately broken.
+
+## Types
+
+`TypesIMGUITest` and `TypesUIToolkitTest` carry the same fields — `SerializableType`, its generic and
+`SerializableMonoScript` variants, `[TypeSelector]` on strings and arrays, every `TypeAllow` category,
+`Required`, and a `nameof` member reference. `TypesIMGUITestEditor` forces the first one through IMGUI,
+so `Prefabs/TypesDevTest.prefab` shows both renderings of one field list side by side.
+
+The prefab's `FastEnemy` child covers `ComponentTypeSelector`: `EnemyBaseEditor` is registered with
+`editorForChildClasses: true`, so the inspector stays in IMGUI after the component swaps its own type.
+
+`Scripts/DocsMedia` holds the types that appear in the published screenshots of
+`Documentation/02-serializable-types.md`. Their namespaces are neutral and game-like because picker
+breadcrumbs are visible in the captures; changing a name or a group there invalidates an image.
+
+## SerializeReferences
+
+`SerializeReferencesIMGUITest` and `SerializeReferencesUIToolkitTest` cover the notice states on
+`Prefabs/SerializeReferencesDevTest.prefab`: an unset `Required` reference, one instance shared by two
+fields, a missing type with Fix and Smart Fix, and a missing element inside a list.
+
+`RequiredViolationsDevTest` leaves a managed reference and a type name unset on purpose, which is what
+the Project References window groups under required violations and the Asset References window badges.
+
+This folder is listed under **Excluded folders** in the project's SerializeReference settings, so the
+project-wide scan and the `sr_gate` command pass over everything here; the samples carry their own broken
+assets for that. Remove the entry to see these fixtures in Project References, and put it back afterwards.
+
+`Scripts/Fixtures` backs three prefabs that exist as files rather than inspectors, because the audit
+windows scan assets on disk: `WeaponPreset` (two ordinary references), `SharedWeaponPreset` (one
+instance behind both fields) and `BrokenWeaponPreset` (a stored class name that resolves to nothing).
+
+## Enums
+
+`EnumValuesIMGUITest` and `EnumValuesUIToolkitTest` pair the same tables on
+`Prefabs/EnumValuesDevTest.prefab`: the untyped variant with its type-picker row, single-line and
+multi-field values, `[Flags]` keys, object-reference values, and tables inside an array.
+
+## CliCommands
+
+`sr_gate` exposes the SerializeReference gate scanner to `unity command`, so the scan returns JSON from
+the running Editor instead of a batchmode relaunch. It is the only assembly here, because it needs the
+package's internals.

Aspid.FastTools/Assets/DevTests/SerializeReferences/Prefabs/BrokenWeaponPreset.prefab

@@ -58,5 +58,5 @@ MonoBehaviour:
     - rid: 2339642446330462276
       type: {class: Shotgun, ns: Game.Gear, asm: Assembly-CSharp}
       data:
+        _damage: 37
         _pellets: 8
-        _spread: 12

Aspid.FastTools/Assets/DevTests/SerializeReferences/Prefabs/SerializeReferencesDevTest.prefab

@@ -0,0 +1,123 @@
+%YAML 1.1
+%TAG !u! tag:unity3d.com,2011:
+--- !u!1 &7412330891455062001
+GameObject:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  serializedVersion: 6
+  m_Component:
+  - component: {fileID: 7412330891455062002}
+  - component: {fileID: 7412330891455062003}
+  - component: {fileID: 7412330891455062004}
+  m_Layer: 0
+  m_Name: SerializeReferencesDevTest
+  m_TagString: Untagged
+  m_Icon: {fileID: 0}
+  m_NavMeshLayer: 0
+  m_StaticEditorFlags: 0
+  m_IsActive: 1
+--- !u!4 &7412330891455062002
+Transform:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7412330891455062001}
+  serializedVersion: 2
+  m_LocalRotation: {x: 0, y: 0, z: 0, w: 1}
+  m_LocalPosition: {x: 0, y: 0, z: 0}
+  m_LocalScale: {x: 1, y: 1, z: 1}
+  m_ConstrainProportionsScale: 0
+  m_Children: []
+  m_Father: {fileID: 0}
+  m_LocalEulerAnglesHint: {x: 0, y: 0, z: 0}
+--- !u!114 &7412330891455062003
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7412330891455062001}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: b420f95844b84734b4a50fffdc0a01e3, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: Assembly-CSharp::Aspid.FastTools.DevTests.SerializeReferences.SerializeReferencesIMGUITest
+  _required:
+    rid: -2
+  _sharedLeft:
+    rid: 7412330891455063000
+  _sharedRight:
+    rid: 7412330891455063000
+  _missing:
+    rid: 7412330891455063001
+  _missingInList:
+  - rid: 7412330891455063002
+  - rid: 7412330891455063003
+  references:
+    version: 2
+    RefIds:
+    - rid: 7412330891455063000
+      type: {class: Pistol, ns: Game.Gear, asm: Assembly-CSharp}
+      data:
+        _damage: 12
+    - rid: 7412330891455063001
+      type: {class: Pistoll, ns: Game.Gear, asm: Assembly-CSharp}
+      data:
+        _damage: 37
+    - rid: 7412330891455063002
+      type: {class: Shotgun, ns: Game.Gear, asm: Assembly-CSharp}
+      data:
+        _damage: 20
+        _pellets: 6
+    - rid: 7412330891455063003
+      type: {class: Shotgunn, ns: Game.Gear, asm: Assembly-CSharp}
+      data:
+        _damage: 44
+        _pellets: 8
+--- !u!114 &7412330891455062004
+MonoBehaviour:
+  m_ObjectHideFlags: 0
+  m_CorrespondingSourceObject: {fileID: 0}
+  m_PrefabInstance: {fileID: 0}
+  m_PrefabAsset: {fileID: 0}
+  m_GameObject: {fileID: 7412330891455062001}
+  m_Enabled: 1
+  m_EditorHideFlags: 0
+  m_Script: {fileID: 11500000, guid: 19ed43d7d91a47a7b0ed8f22852b914d, type: 3}
+  m_Name: 
+  m_EditorClassIdentifier: Assembly-CSharp::Aspid.FastTools.DevTests.SerializeReferences.SerializeReferencesUIToolkitTest
+  _required:
+    rid: -2
+  _sharedLeft:
+    rid: 7412330891455064000
+  _sharedRight:
+    rid: 7412330891455064000
+  _missing:
+    rid: 7412330891455064001
+  _missingInList:
+  - rid: 7412330891455064002
+  - rid: 7412330891455064003
+  references:
+    version: 2
+    RefIds:
+    - rid: 7412330891455064000
+      type: {class: Pistol, ns: Game.Gear, asm: Assembly-CSharp}
+      data:
+        _damage: 12
+    - rid: 7412330891455064001
+      type: {class: Pistoll, ns: Game.Gear, asm: Assembly-CSharp}
+      data:
+        _damage: 37
+    - rid: 7412330891455064002
+      type: {class: Shotgun, ns: Game.Gear, asm: Assembly-CSharp}
+      data:
+        _damage: 20
+        _pellets: 6
+    - rid: 7412330891455064003
+      type: {class: Shotgunn, ns: Game.Gear, asm: Assembly-CSharp}
+      data:
+        _damage: 44
+        _pellets: 8