Merge pull request #385 from estruyf/dev

Version 2.0.0

Author: estruyf

.demo/README.md

@@ -0,0 +1,101 @@
+# Demo Time Act files
+
+This folder contains demonstration files for **Demo Time** using the new
+**Version 3** theatrical structure.
+
+## 🎭 Theatrical Structure
+
+Demo Time uses an intuitive theatrical metaphor:
+
+- **Play** - Your entire demo project (this workspace)
+- **Act** - Each act file (e.g., `example-v3.yaml` or `my-demo.json`)
+- **Scene** - Sections within an Act (previously called "demos")
+- **Move** - Individual actions (previously called "steps")
+
+## 📁 Files in This Folder
+
+### Version 3 (New Format)
+
+- **`example-v3.yaml`** - Example demonstration using version 3 theatrical
+  naming
+  - Shows the new `scenes` and `moves` structure
+  - Demonstrates product icon usage
+  - YAML format
+
+### Version 1 & 2 (Legacy Format)
+
+- **`demo.json`** - Legacy JSON format demo
+- **`sample.json`** - Sample act file
+- **`sample.yaml`** - Sample YAML act file
+- Other `.json` and `.yaml` files - Various demo examples
+
+## 🚀 Quick Start
+
+### Creating a New Version 3 Demo
+
+Create a file named `my-demo.yaml` (or `my-demo.json`):
+
+```yaml
+title: My Demo Act
+description: What this Act demonstrates
+version: 3
+scenes:
+  - title: Introduction Scene
+    moves:
+      - action: showInfoMessage
+        message: Hello from Demo Time v3!
+```
+
+### Product Icons
+
+Choose from any VS Code codicon:
+- `presentation` - General presentations
+- `rocket` - Getting started
+- `lightbulb` - Features
+- `beaker` - Experiments
+- `terminal` - CLI demos
+- `code` - Coding tutorials
+
+## 📚 Documentation
+
+- **Complete Guide:** `/docs/version-3-guide.md`
+- **Migration Guide:** `/MIGRATION-V3.md`
+- **Schema:** `https://demotime.show/demo-time.schema.json`
+
+## ✨ Version 3 Features
+
+- ✅ Theatrical naming (Play, Act, Scene, Move)
+- ✅ Product icons for visual identification
+- ✅ Works with `.json` and `.yaml` files
+- ✅ Full backward compatibility with v1 & v2
+- ✅ Automatic normalization
+
+## 🔄 Backward Compatibility
+
+All existing `.json` and `.yaml` act files continue to work without
+modification. You can mix version 1, 2, and 3 files in the same project.
+
+## 🎬 Example Structure
+
+```yaml
+title: Getting Started
+version: 3
+scenes:
+  - title: Installation
+    moves:
+      - action: create
+        path: package.json
+        content: {...}
+      - action: open
+        path: package.json
+
+  - title: First Steps
+    moves:
+      - action: showInfoMessage
+        message: You're all set!
+```
+
+## 📖 Learn More
+
+Visit [demotime.show](https://demotime.show/) for complete documentation and
+examples.

.demo/example-v3.yaml

@@ -0,0 +1,55 @@
+title: Example Version 3 Demo
+description: Demonstrates the new theatrical naming conventions in Demo Time v3
+version: 3
+timer: 15
+scenes:
+  - id: scene-1
+    title: Opening Scene - Introduction
+    description: Welcome the audience and introduce the demo
+    icons:
+      start: play-circle
+      end: check-circle
+    moves:
+      - action: create
+        path: welcome.md
+        content: |
+          # Welcome to Demo Time v3!
+
+          This demo uses the new theatrical structure:
+          - **Play**: Your entire demo project
+          - **Act**: This act file (example-v3.yaml)
+          - **Scene**: Each section of your presentation
+          - **Move**: Individual actions that build your narrative
+      - action: open
+        path: welcome.md
+      - action: waitForTimeout
+        timeout: 2000
+
+  - id: scene-2
+    title: Feature Demonstration
+    description: Show off the key features
+    moves:
+      - action: create
+        path: features.ts
+        content: |
+          // Demo Time v3 Features
+          export const features = {
+            theatrical: 'Intuitive naming structure',
+            versioning: 'Version 3 with backward compatibility',
+            fileFormat: 'JSON or YAML files'
+          };
+      - action: open
+        path: features.ts
+      - action: highlight
+        path: features.ts
+        position: "2:1:6:3"
+      - action: showInfoMessage
+        message: These are the new features in Demo Time v3!
+
+  - id: scene-3
+    title: Closing Scene - Summary
+    description: Wrap up and thank the audience
+    moves:
+      - action: closeAll
+      - action: showInfoMessage
+        message: Thank you for watching this Demo Time v3 presentation!

.demo/sample.yaml

@@ -1,6 +1,6 @@
 $schema: https://demotime.show/demo-time.schema.json
 title: Sample YAML Demo
-description: This is a test YAML demo file
+description: This is a test YAML act file
 version: 2
 demos:
   - title: Step 1
@@ -10,4 +10,4 @@ demos:
         path: test.txt
         content: Hello YAML World
       - action: open
-        path: test.txt
+        path: test.txt

.demo/test-global-duplicates.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://demotime.show/demo-time.schema.json",
   "title": "Test Global Duplicates",
-  "description": "Demo file to test global duplicate ID validation",
+  "description": "Act file to test global duplicate ID validation",
   "demos": [
     {
       "id": "demo1",

.demo/test-validation.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://demotime.show/demo-time.schema.json",
   "title": "Test Validation",
-  "description": "Demo file to test duplicate ID validation",
+  "description": "Act file to test duplicate ID validation",
   "demos": [
     {
       "id": "demo1",

.demo/test-validation.yaml

@@ -1,6 +1,6 @@
 $schema: https://demotime.show/demo-time.schema.json
 title: Test YAML Validation
-description: YAML demo file to test duplicate ID validation
+description: YAML act file to test duplicate ID validation
 demos:
   - id: yaml-demo1
     title: First YAML Demo

.github/copilot-instructions.md

@@ -17,7 +17,7 @@
 
 ## Key Patterns & Conventions
 
-- **Demo File Format:**
+- **Act file Format:**
   - JSON or YAML, with a schema at the top-level (`$schema`).
   - `demos` is an array; each demo has `title`, `description`, `steps`, and optional `icons`.
   - Steps use a defined set of actions (see `src/utils/getActionOptions.ts`).
@@ -46,18 +46,18 @@
 
 ## Integration & Data Flow
 
-- **Demo execution** flows from the demo file → parsed by services → actions dispatched to VS
+- **Demo execution** flows from the act file → parsed by services → actions dispatched to VS
   Code/editor APIs.
 - **Panels** (webviews) communicate with the extension via message passing (see `WebViewMessages` in
   `constants`).
 - **Snippets** are loaded and parameterized at runtime for reusable demo logic.
 
 ## Examples
 
-- See `README.md` for a full demo file example.
+- See `README.md` for a full act file example.
 - See `snippets/README.md` for snippet usage and configuration.
 
 ---
 
 For more, see [https://demotime.show](https://demotime.show) and the in-repo documentation. If you
-add new actions or demo file features, update the schema and documentation accordingly.
+add new actions or act file features, update the schema and documentation accordingly.