Merge pull request #19 from bethropolis/dev

Author: bethropolis

.npmignore

@@ -0,0 +1,41 @@
+# Development
+.github/
+.vscode/
+.idea/
+
+# Documentation
+docs/
+*.md
+!README.md
+!LICENSE
+
+# Playground and extensions
+playground/
+extensions/
+
+# Tests
+test/
+*.test.js
+*.spec.js
+
+# Build artifacts
+*.bundle.js
+*.min.js
+
+# Config files
+.eslintrc*
+.prettierrc*
+jsconfig.json
+tsconfig.json
+vite.config.*
+tailwind.config.*
+postcss.config.*
+svelte.config.*
+
+# Misc
+.DS_Store
+Thumbs.db
+*.log
+.env
+.env.*
+!.env.example

docs/_sidebar.md

@@ -19,6 +19,6 @@
   * [Array Operations](syntax/array-operations.md)
   * [Style Guide](syntax/style-guide.md)
 * Examples
-  * [Inventory](examples/inventory/app.mimo)
-  * [Quiz](examples/quiz/main.mimo)
-  * [Task Manager](examples/task-manager/main.mimo)
+  * [Inventory](examples/inventory/README.md)
+  * [Quiz](examples/quiz/README.md)
+  * [Task Manager](examples/task-manager/README.md)

docs/examples/inventory/README.md

@@ -0,0 +1,89 @@
+# Inventory Example
+
+A product catalog system with dynamic pricing based on user type.
+
+## Files
+
+- `catalog.mimo` - Product data and search
+- `pricing.mimo` - Discount calculation with pattern matching  
+- `app.mimo` - Main application
+
+## catalog.mimo
+
+```mimo
+export const PRODUCTS [
+    { id: "P1", name: "Laptop", price: 1200, category: "electronics", stock: 10 },
+    { id: "P2", name: "Mouse", price: 25, category: "electronics", stock: 50 },
+    { id: "P3", name: "Shirt", price: 30, category: "clothing", stock: 100 },
+    { id: "P4", name: "Keyboard", price: 75, category: "electronics", stock: 0 }
+]
+
+export function find_product(id)
+    for p in PRODUCTS
+        if = p.id id
+            return p
+        end
+    end
+    return null
+end
+```
+
+## pricing.mimo
+
+```mimo
+import "math" as math
+
+export function calculate_discount(product, user_type)
+    match [product.category, user_type]
+        case ["electronics", "VIP"]:
+            return 0.20  // 20% off
+        case ["electronics", "standard"]:
+            return 0.05  // 5% off electronics for everyone
+        case ["clothing", "VIP"]:
+            return 0.15  // 15% off clothing for VIP
+        default:
+            return 0.0
+    end
+end
+
+export function get_final_price(product, user_type)
+    set discount call calculate_discount(product, user_type)
+    set reduction * product.price discount
+    return - product.price reduction
+end
+```
+
+## app.mimo
+
+```mimo
+import "./catalog.mimo" as catalog
+import "./pricing.mimo" as pricing
+
+show "--- Mimo Inventory Report ---"
+
+for p in catalog.PRODUCTS
+    set status call if_else(> p.stock 0, "In Stock", "Out of Stock")
+    show `Product: ${p.name} | Price: $${p.price} | ${status}`
+    
+    if > p.stock 0
+        set vip_price call pricing.get_final_price(p, "VIP")
+        show `  -> VIP Special Price: $${vip_price}`
+    end
+end
+
+show "--- End of Report ---"
+```
+
+## Output
+
+```
+--- Mimo Inventory Report ---
+Product: Laptop | Price: $1200 | In Stock
+  -> VIP Special Price: $960
+Product: Mouse | Price: $25 | In Stock
+  -> VIP Special Price: $20
+Product: Shirt | Price: $30 | In Stock
+  -> VIP Special Price: $25.5
+Product: Keyboard | Price: $75 | Out of Stock
+--- End of Report ---
+```

docs/examples/inventory/app.mimo

@@ -0,0 +1,118 @@
+# Quiz Example
+
+A simple quiz application demonstrating modules and data structures.
+
+## Files
+
+- `data.mimo` - Quiz questions data
+- `engine.mimo` - Quiz logic functions
+- `main.mimo` - Main quiz application
+
+## data.mimo
+
+```mimo
+export const QUESTIONS [
+    {
+        q: "What is the result of '+ 2 3' in Mimo?",
+        a: "5",
+        options: ["1", "5", "6", "23"]
+    },
+    {
+        q: "Which keyword is used for block-scoped variables?",
+        a: "let",
+        options: ["set", "let", "const", "var"]
+    },
+    {
+        q: "Is Mimo dynamically typed?",
+        a: "yes",
+        options: ["yes", "no"]
+    }
+]
+```
+
+## engine.mimo
+
+```mimo
+import "array" as array
+
+export function check_answer(question, user_answer)
+    return = question.a user_answer
+end
+
+export function get_score_percentage(correct, total)
+    return * (/ correct total) 100
+end
+```
+
+## main.mimo
+
+```mimo
+import "./data.mimo" as data
+import "./engine.mimo" as engine
+
+show "--- Mimo Programming Quiz ---"
+show `Starting quiz with ${call len(data.QUESTIONS)} questions.`
+
+let score 0
+
+for q in data.QUESTIONS
+    show ""
+    show `Question: ${q.q}`
+    // Display options
+    show `  A) ${q.options[0]}`
+    show `  B) ${q.options[1]}`
+    if > call len(q.options) 2
+        show `  C) ${q.options[2]}`
+    end
+    if > call len(q.options) 3
+        show `  D) ${q.options[3]}`
+    end
+    
+    // Simulate an answer
+    set simulated_choice q.a
+    show `Your answer: ${simulated_choice}`
+    
+    if call engine.check_answer(q, simulated_choice)
+        show "Correct!"
+        set score + score 1
+    else
+        show `Wrong! The correct answer was: ${q.a}`
+    end
+end
+
+show ""
+show "--- Quiz Results ---"
+show `Score: ${score} / ${call len(data.QUESTIONS)}`
+set percent call engine.get_score_percentage(score, call len(data.QUESTIONS))
+show `Grade: ${percent}%`
+
+if = percent 100
+    show "Perfect Score!"
+else
+    if >= percent 70
+        show "Well done!"
+    else
+        show "Keep practicing!"
+    end
+end
+```
+
+## Output
+
+```
+--- Mimo Programming Quiz ---
+Starting quiz with 3 questions.
+
+Question: What is the result of '+ 2 3' in Mimo?
+  A) 1
+  B) 5
+  C) 6
+  D) 23
+Your answer: 5
+Correct!
+
+--- Quiz Results ---
+Score: 3 / 3
+Grade: 100%
+Perfect Score!
+```