odac 0.9.0 → 1.0.0

package/docs/backend/07-views/04-request-data.md

@@ -1,23 +1,23 @@
 ## 🔗 Request Data (Query Parameters)
 
-The `<candy get>` tag allows you to access URL query parameters directly in your views. This is useful for forms, filters, and pagination.
+The `<odac get>` tag allows you to access URL query parameters directly in your views. This is useful for forms, filters, and pagination.
 
 ### Getting Query Parameters
 
-Use `<candy get="key" />` to access URL query parameters:
+Use `<odac get="key" />` to access URL query parameters:
 
-**Important:** `<candy get>` is for **query parameters** (URL parameters), not for data from controllers. For controller data, use `<candy var>` (see [Variables](./03-variables.md)).
+**Important:** `<odac get>` is for **query parameters** (URL parameters), not for data from controllers. For controller data, use `<odac var>` (see [Variables](./03-variables.md)).
 
 ```html
 <!-- URL: /search?q=laptop&page=2 -->
 
-<p>Search query: <candy get="q" /></p>
-<p>Current page: <candy get="page" /></p>
+<p>Search query: <odac get="q" /></p>
+<p>Current page: <odac get="page" /></p>
 ```
 
 **How it works:**
 1. User visits `/search?q=laptop&page=2`
-2. `<candy get="q" />` retrieves the value of `q` parameter
+2. `<odac get="q" />` retrieves the value of `q` parameter
 3. If parameter doesn't exist, it returns empty string (no error)
 
 ### Undefined Parameters
@@ -27,7 +27,7 @@ If a parameter doesn't exist, it safely returns an empty string:
 ```html
 <!-- URL: /products (no query parameters) -->
 
-<candy get="search" />
+<odac get="search" />
 <!-- Output: (empty string, no error) -->
 ```
 
@@ -35,86 +35,86 @@ This prevents errors when parameters are optional.
 
 ### Difference: get vs var
 
-**`<candy get>` - Query Parameters (from URL):**
+**`<odac get>` - Query Parameters (from URL):**
 ```html
 <!-- URL: /search?q=laptop -->
-<candy get="q" />
+<odac get="q" />
 <!-- Output: laptop -->
 ```
 
-**`<candy var>` - Controller Data (from Candy.set()):**
+**`<odac var>` - Controller Data (from Odac.set()):**
 ```javascript
 // Controller
-Candy.set('productName', 'Laptop')
+Odac.set('productName', 'Laptop')
 ```
 ```html
 <!-- View -->
-<candy var="productName" />
+<odac var="productName" />
 <!-- Output: Laptop -->
 ```
 
 ### Processing Request Data in Controllers
 
-While you can access query parameters directly in views with `<candy get>`, it's often better to process them in the controller:
+While you can access query parameters directly in views with `<odac get>`, it's often better to process them in the controller:
 
 ```javascript
 // Controller: controller/search.js
-module.exports = async function(Candy) {
+module.exports = async function(Odac) {
   // Get query parameters
-  const query = Candy.Request.get('q') || 'all products'
-  const page = parseInt(Candy.Request.get('page')) || 1
+  const query = Odac.Request.get('q') || 'all products'
+  const page = parseInt(Odac.Request.get('page')) || 1
   
   // Validate and process
   const validatedQuery = query.trim()
   const validatedPage = Math.max(1, page)
   
   // Fetch results
-  const results = await Candy.Mysql.table('products')
+  const results = await Odac.Mysql.table('products')
     .where('name', 'like', `%${validatedQuery}%`)
     .limit(20)
     .offset((validatedPage - 1) * 20)
     .get()
   
   // Pass processed data to view
-  Candy.set({
+  Odac.set({
     query: validatedQuery,
     page: validatedPage,
     results: results
   })
   
-  Candy.View.skeleton('main').set('content', 'search')
+  Odac.View.skeleton('main').set('content', 'search')
 }
 ```
 
 ```html
 <!-- View: view/content/search.html -->
-<h1>Search Results for "<candy var="query" />"</h1>
-<p>Page <candy var="page" /></p>
+<h1>Search Results for "<odac var="query" />"</h1>
+<p>Page <odac var="page" /></p>
 
-<candy:for in="results" value="product">
+<odac:for in="results" value="product">
   <div class="product">
-    <h3><candy var="product.name" /></h3>
-    <p><candy var="product.price" /></p>
+    <h3><odac var="product.name" /></h3>
+    <p><odac var="product.price" /></p>
   </div>
-</candy:for>
+</odac:for>
 ```
 
 ### Accessing Request Object
 
-You can access the full Request object through the Candy object:
+You can access the full Request object through the Odac object:
 
 ```html
 <!-- Request method -->
-<p>Method: <candy var="Candy.Request.method" /></p>
+<p>Method: <odac var="Odac.Request.method" /></p>
 
 <!-- Current URL -->
-<p>URL: <candy var="Candy.Request.url" /></p>
+<p>URL: <odac var="Odac.Request.url" /></p>
 
 <!-- Client IP -->
-<p>IP: <candy var="Candy.Request.ip" /></p>
+<p>IP: <odac var="Odac.Request.ip" /></p>
 
 <!-- User agent -->
-<p>Browser: <candy var="Candy.Request.headers['user-agent']" /></p>
+<p>Browser: <odac var="Odac.Request.headers['user-agent']" /></p>
 ```
 
 ### Practical Examples
@@ -127,36 +127,36 @@ You can access the full Request object through the Candy object:
   <input 
     type="text" 
     name="q" 
-    value="<candy get="q" />" 
+    value="<odac get="q" />" 
     placeholder="Search products..."
   >
   <button type="submit">Search</button>
 </form>
 
 <!-- Display search query if exists -->
-<candy:if condition="Candy.Request.get('q')">
-  <p>Showing results for: "<candy get="q" />"</p>
-</candy:if>
+<odac:if condition="Odac.Request.get('q')">
+  <p>Showing results for: "<odac get="q" />"</p>
+</odac:if>
 ```
 
 #### Pagination
 
 ```html
-<script:candy>
-  const currentPage = parseInt(Candy.Request.get('page')) || 1
+<script:odac>
+  const currentPage = parseInt(Odac.Request.get('page')) || 1
   const totalPages = 10
-</script:candy>
+</script:odac>
 
 <div class="pagination">
-  <candy:if condition="currentPage > 1">
-    <a href="?page=<candy var="currentPage - 1" />">Previous</a>
-  </candy:if>
+  <odac:if condition="currentPage > 1">
+    <a href="?page=<odac var="currentPage - 1" />">Previous</a>
+  </odac:if>
   
-  <span>Page <candy var="currentPage" /> of <candy var="totalPages" /></span>
+  <span>Page <odac var="currentPage" /> of <odac var="totalPages" /></span>
   
-  <candy:if condition="currentPage < totalPages">
-    <a href="?page=<candy var="currentPage + 1" />">Next</a>
-  </candy:if>
+  <odac:if condition="currentPage < totalPages">
+    <a href="?page=<odac var="currentPage + 1" />">Next</a>
+  </odac:if>
 </div>
 ```
 
@@ -168,19 +168,19 @@ You can access the full Request object through the Candy object:
 <form action="/products" method="GET">
   <select name="category">
     <option value="">All Categories</option>
-    <option value="electronics" <candy:if condition="Candy.Request.get('category') === 'electronics'">selected</candy:if>>
+    <option value="electronics" <odac:if condition="Odac.Request.get('category') === 'electronics'">selected</odac:if>>
       Electronics
     </option>
-    <option value="clothing" <candy:if condition="Candy.Request.get('category') === 'clothing'">selected</candy:if>>
+    <option value="clothing" <odac:if condition="Odac.Request.get('category') === 'clothing'">selected</odac:if>>
       Clothing
     </option>
   </select>
   
   <select name="sort">
-    <option value="name" <candy:if condition="Candy.Request.get('sort') === 'name'">selected</candy:if>>
+    <option value="name" <odac:if condition="Odac.Request.get('sort') === 'name'">selected</odac:if>>
       Name
     </option>
-    <option value="price" <candy:if condition="Candy.Request.get('sort') === 'price'">selected</candy:if>>
+    <option value="price" <odac:if condition="Odac.Request.get('sort') === 'price'">selected</odac:if>>
       Price
     </option>
   </select>
@@ -193,13 +193,13 @@ You can access the full Request object through the Candy object:
 
 ```html
 <nav>
-  <a href="/" class="<candy:if condition="Candy.Request.url === '/'">active</candy:if>">
+  <a href="/" class="<odac:if condition="Odac.Request.url === '/'">active</odac:if>">
     Home
   </a>
-  <a href="/products" class="<candy:if condition="Candy.Request.url.startsWith('/products')">active</candy:if>">
+  <a href="/products" class="<odac:if condition="Odac.Request.url.startsWith('/products')">active</odac:if>">
     Products
   </a>
-  <a href="/about" class="<candy:if condition="Candy.Request.url === '/about'">active</candy:if>">
+  <a href="/about" class="<odac:if condition="Odac.Request.url === '/about'">active</odac:if>">
     About
   </a>
 </nav>
@@ -215,17 +215,17 @@ You can access the full Request object through the Candy object:
 **Good:**
 ```javascript
 // Controller
-const page = Math.max(1, parseInt(Candy.Request.get('page')) || 1)
-const limit = Math.min(100, parseInt(Candy.Request.get('limit')) || 20)
+const page = Math.max(1, parseInt(Odac.Request.get('page')) || 1)
+const limit = Math.min(100, parseInt(Odac.Request.get('limit')) || 20)
 
-Candy.set('page', page)
-Candy.set('limit', limit)
+Odac.set('page', page)
+Odac.set('limit', limit)
 ```
 
 **Avoid:**
 ```html
 <!-- Don't do complex logic in views -->
-<candy:if condition="parseInt(Candy.Request.get('page')) > 0 && parseInt(Candy.Request.get('page')) < 100">
+<odac:if condition="parseInt(Odac.Request.get('page')) > 0 && parseInt(Odac.Request.get('page')) < 100">
   ...
-</candy:if>
+</odac:if>
 ```

package/docs/backend/07-views/05-conditionals.md

@@ -5,9 +5,9 @@ Conditionals allow you to show or hide content based on conditions. This is esse
 ### Basic If Statement
 
 ```html
-<candy:if condition="user.isAdmin">
+<odac:if condition="user.isAdmin">
   <p>Welcome to the admin panel!</p>
-</candy:if>
+</odac:if>
 ```
 
 The content inside the tag is only rendered if the condition is true.
@@ -15,33 +15,33 @@ The content inside the tag is only rendered if the condition is true.
 ### If-Else Structure
 
 ```html
-<candy:if condition="user.isLoggedIn">
-  <p>Welcome back, <candy var="user.name" />!</p>
-<candy:else>
+<odac:if condition="user.isLoggedIn">
+  <p>Welcome back, <odac var="user.name" />!</p>
+<odac:else>
   <p>Please log in to continue.</p>
-</candy:if>
+</odac:if>
 ```
 
 ### If-ElseIf-Else Structure
 
 ```html
-<candy:if condition="user.role === 'admin'">
+<odac:if condition="user.role === 'admin'">
   <div class="admin-panel">
     <p>You have full admin privileges</p>
   </div>
-<candy:elseif condition="user.role === 'moderator'">
+<odac:elseif condition="user.role === 'moderator'">
   <div class="moderator-panel">
     <p>You have moderator privileges</p>
   </div>
-<candy:elseif condition="user.role === 'editor'">
+<odac:elseif condition="user.role === 'editor'">
   <div class="editor-panel">
     <p>You have editor privileges</p>
   </div>
-<candy:else>
+<odac:else>
   <div class="user-panel">
     <p>You have regular user privileges</p>
   </div>
-</candy:if>
+</odac:if>
 ```
 
 ### Condition Syntax
@@ -50,40 +50,40 @@ Conditions use standard JavaScript expressions:
 
 ```html
 <!-- Equality -->
-<candy:if condition="status === 'active'">Active</candy:if>
+<odac:if condition="status === 'active'">Active</odac:if>
 
 <!-- Comparison -->
-<candy:if condition="age >= 18">Adult</candy:if>
-<candy:if condition="price < 100">Affordable</candy:if>
+<odac:if condition="age >= 18">Adult</odac:if>
+<odac:if condition="price < 100">Affordable</odac:if>
 
 <!-- Logical operators -->
-<candy:if condition="user.isVerified && user.isPremium">
+<odac:if condition="user.isVerified && user.isPremium">
   Premium Verified User
-</candy:if>
+</odac:if>
 
-<candy:if condition="role === 'admin' || role === 'moderator'">
+<odac:if condition="role === 'admin' || role === 'moderator'">
   Staff Member
-</candy:if>
+</odac:if>
 
 <!-- Negation -->
-<candy:if condition="!user.isBanned">
+<odac:if condition="!user.isBanned">
   Welcome!
-</candy:if>
+</odac:if>
 
 <!-- Existence check -->
-<candy:if condition="user">
+<odac:if condition="user">
   User exists
-</candy:if>
+</odac:if>
 
 <!-- Array/String length -->
-<candy:if condition="items.length > 0">
+<odac:if condition="items.length > 0">
   You have items
-</candy:if>
+</odac:if>
 
 <!-- Method calls -->
-<candy:if condition="Candy.Auth.check()">
+<odac:if condition="Odac.Auth.check()">
   Logged in
-</candy:if>
+</odac:if>
 ```
 
 ### Practical Examples
@@ -92,14 +92,14 @@ Conditions use standard JavaScript expressions:
 
 ```html
 <nav>
-  <candy:if condition="Candy.Auth.check()">
+  <odac:if condition="Odac.Auth.check()">
     <a href="/profile">Profile</a>
     <a href="/settings">Settings</a>
     <a href="/logout">Logout</a>
-  <candy:else>
+  <odac:else>
     <a href="/login">Login</a>
     <a href="/register">Register</a>
-  </candy:if>
+  </odac:if>
 </nav>
 ```
 
@@ -107,19 +107,19 @@ Conditions use standard JavaScript expressions:
 
 ```html
 <div class="product">
-  <h3><candy var="product.name" /></h3>
-  <p class="price">$<candy var="product.price" /></p>
+  <h3><odac var="product.name" /></h3>
+  <p class="price">$<odac var="product.price" /></p>
   
-  <candy:if condition="product.stock > 10">
+  <odac:if condition="product.stock > 10">
     <span class="badge in-stock">In Stock</span>
     <button>Add to Cart</button>
-  <candy:elseif condition="product.stock > 0">
-    <span class="badge low-stock">Only <candy var="product.stock" /> left!</span>
+  <odac:elseif condition="product.stock > 0">
+    <span class="badge low-stock">Only <odac var="product.stock" /> left!</span>
     <button>Add to Cart</button>
-  <candy:else>
+  <odac:else>
     <span class="badge out-of-stock">Out of Stock</span>
     <button disabled>Notify Me</button>
-  </candy:if>
+  </odac:if>
 </div>
 ```
 
@@ -129,22 +129,22 @@ Conditions use standard JavaScript expressions:
 <div class="dashboard">
   <h1>Dashboard</h1>
   
-  <candy:if condition="user.role === 'admin'">
+  <odac:if condition="user.role === 'admin'">
     <div class="admin-section">
       <h2>Admin Tools</h2>
       <a href="/admin/users">Manage Users</a>
       <a href="/admin/settings">System Settings</a>
       <a href="/admin/logs">View Logs</a>
     </div>
-  </candy:if>
+  </odac:if>
   
-  <candy:if condition="user.role === 'admin' || user.role === 'moderator'">
+  <odac:if condition="user.role === 'admin' || user.role === 'moderator'">
     <div class="moderation-section">
       <h2>Moderation</h2>
       <a href="/moderate/posts">Review Posts</a>
       <a href="/moderate/reports">Handle Reports</a>
     </div>
-  </candy:if>
+  </odac:if>
   
   <div class="user-section">
     <h2>Your Content</h2>
@@ -160,27 +160,27 @@ Conditions use standard JavaScript expressions:
 <form>
   <div class="form-group">
     <label>Email</label>
-    <input type="email" name="email" value="<candy var="email" />">
+    <input type="email" name="email" value="<odac var="email" />">
     
-    <candy:if condition="errors && errors.email">
-      <span class="error"><candy var="errors.email" /></span>
-    </candy:if>
+    <odac:if condition="errors && errors.email">
+      <span class="error"><odac var="errors.email" /></span>
+    </odac:if>
   </div>
   
   <div class="form-group">
     <label>Password</label>
     <input type="password" name="password">
     
-    <candy:if condition="errors && errors.password">
-      <span class="error"><candy var="errors.password" /></span>
-    </candy:if>
+    <odac:if condition="errors && errors.password">
+      <span class="error"><odac var="errors.password" /></span>
+    </odac:if>
   </div>
   
-  <candy:if condition="success">
+  <odac:if condition="success">
     <div class="success-message">
-      <candy var="success" />
+      <odac var="success" />
     </div>
-  </candy:if>
+  </odac:if>
   
   <button type="submit">Submit</button>
 </form>
@@ -189,75 +189,75 @@ Conditions use standard JavaScript expressions:
 #### Conditional CSS Classes
 
 ```html
-<div class="user-card <candy:if condition="user.isPremium">premium</candy:if> <candy:if condition="user.isVerified">verified</candy:if>">
-  <h3><candy var="user.name" /></h3>
+<div class="user-card <odac:if condition="user.isPremium">premium</odac:if> <odac:if condition="user.isVerified">verified</odac:if>">
+  <h3><odac var="user.name" /></h3>
   
-  <candy:if condition="user.isPremium">
+  <odac:if condition="user.isPremium">
     <span class="badge">⭐ Premium</span>
-  </candy:if>
+  </odac:if>
   
-  <candy:if condition="user.isVerified">
+  <odac:if condition="user.isVerified">
     <span class="badge">✓ Verified</span>
-  </candy:if>
+  </odac:if>
 </div>
 ```
 
 #### Nested Conditions
 
 ```html
-<candy:if condition="user">
-  <candy:if condition="user.isActive">
-    <candy:if condition="user.subscription">
-      <candy:if condition="user.subscription.status === 'active'">
+<odac:if condition="user">
+  <odac:if condition="user.isActive">
+    <odac:if condition="user.subscription">
+      <odac:if condition="user.subscription.status === 'active'">
         <div class="premium-content">
           <h2>Premium Content</h2>
           <p>Welcome, premium member!</p>
         </div>
-      <candy:elseif condition="user.subscription.status === 'expired'">
+      <odac:elseif condition="user.subscription.status === 'expired'">
         <div class="renewal-notice">
           <p>Your subscription has expired. Please renew to continue.</p>
           <a href="/renew">Renew Now</a>
         </div>
-      </candy:if>
-    <candy:else>
+      </odac:if>
+    <odac:else>
       <div class="upgrade-notice">
         <p>Upgrade to premium for exclusive content!</p>
         <a href="/upgrade">Upgrade Now</a>
       </div>
-    </candy:if>
-  <candy:else>
+    </odac:if>
+  <odac:else>
     <div class="inactive-notice">
       <p>Your account is inactive. Please contact support.</p>
     </div>
-  </candy:if>
-<candy:else>
+  </odac:if>
+<odac:else>
   <div class="login-notice">
     <p>Please log in to view this content.</p>
     <a href="/login">Login</a>
   </div>
-</candy:if>
+</odac:if>
 ```
 
 #### Conditional Attributes
 
 ```html
 <!-- Disabled button -->
-<button <candy:if condition="!canSubmit">disabled</candy:if>>
+<button <odac:if condition="!canSubmit">disabled</odac:if>>
   Submit
 </button>
 
 <!-- Selected option -->
 <select name="country">
-  <option value="tr" <candy:if condition="country === 'tr'">selected</candy:if>>Turkey</option>
-  <option value="us" <candy:if condition="country === 'us'">selected</candy:if>>USA</option>
-  <option value="uk" <candy:if condition="country === 'uk'">selected</candy:if>>UK</option>
+  <option value="tr" <odac:if condition="country === 'tr'">selected</odac:if>>Turkey</option>
+  <option value="us" <odac:if condition="country === 'us'">selected</odac:if>>USA</option>
+  <option value="uk" <odac:if condition="country === 'uk'">selected</odac:if>>UK</option>
 </select>
 
 <!-- Checked checkbox -->
 <input 
   type="checkbox" 
   name="terms" 
-  <candy:if condition="termsAccepted">checked</candy:if>
+  <odac:if condition="termsAccepted">checked</odac:if>
 >
 ```
 
@@ -271,20 +271,20 @@ Conditions use standard JavaScript expressions:
 **Good:**
 ```javascript
 // Controller
-Candy.set('canEdit', user.isAdmin || user.id === post.authorId)
+Odac.set('canEdit', user.isAdmin || user.id === post.authorId)
 ```
 
 ```html
 <!-- View -->
-<candy:if condition="canEdit">
+<odac:if condition="canEdit">
   <button>Edit</button>
-</candy:if>
+</odac:if>
 ```
 
 **Avoid:**
 ```html
 <!-- Too complex for a view -->
-<candy:if condition="(user && user.role === 'admin') || (user && post && user.id === post.authorId && !post.isLocked)">
+<odac:if condition="(user && user.role === 'admin') || (user && post && user.id === post.authorId && !post.isLocked)">
   <button>Edit</button>
-</candy:if>
+</odac:if>
 ```