odac 0.9.0 → 1.0.0

package/docs/frontend/02-ajax-navigation/03-advanced-usage.md

@@ -1,36 +1,36 @@
 # Advanced AJAX Navigation
 
-Advanced techniques and patterns for AJAX navigation in CandyPack.
+Advanced techniques and patterns for AJAX navigation in Odac.
 
 **Note:** All examples assume you have properly configured your skeleton template and controller. See the [Quick Start guide](01-quick-start.md#skeleton-structure-required) for setup instructions.
 
 ## Programmatic Navigation
 
-### Using Candy.load()
+### Using odac.load()
 
 Navigate programmatically from your code:
 
 ```javascript
 // Basic usage
-Candy.load('/about')
+odac.load('/about')
 
 // With callback
-Candy.load('/about', function(page, variables) {
+odac.load('/about', function(page, variables) {
   console.log('Loaded:', page)
   console.log('Data:', variables)
 })
 
 // Without updating history
-Candy.load('/about', callback, false)
+odac.load('/about', callback, false)
 ```
 
 ### Use Cases
 
 **Redirect after form submission:**
 ```javascript
-Candy.form('#my-form', function(data) {
+odac.form('#my-form', function(data) {
   if (data.result.success) {
-    Candy.load('/success')
+    odac.load('/success')
   }
 })
 ```
@@ -38,16 +38,16 @@ Candy.form('#my-form', function(data) {
 **Conditional navigation:**
 ```javascript
 if (user.isLoggedIn) {
-  Candy.load('/dashboard')
+  odac.load('/dashboard')
 } else {
-  Candy.load('/login')
+  odac.load('/login')
 }
 ```
 
 **Timed navigation:**
 ```javascript
 setTimeout(() => {
-  Candy.load('/next-page')
+  odac.load('/next-page')
 }, 3000)
 ```
 
@@ -58,7 +58,7 @@ setTimeout(() => {
 Update different parts of your page simultaneously:
 
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     update: {
       content: 'main',
@@ -75,9 +75,9 @@ Candy.action({
 Define all parts in your controller:
 
 ```javascript
-module.exports = function(Candy) {
-  Candy.View.skeleton('main')
-  Candy.View.set({
+module.exports = function(Odac) {
+  odac.View.skeleton('main')
+  odac.View.set({
     header: 'main',
     content: 'dashboard',
     sidebar: 'dashboard',
@@ -100,7 +100,7 @@ let appState = {
   filters: {}
 }
 
-Candy.action({
+Odac.action({
   navigate: {
     update: 'main',
     on: function(page, variables) {
@@ -121,7 +121,7 @@ Candy.action({
 Persist state across page reloads:
 
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     update: 'main',
     on: function(page, variables) {
@@ -148,7 +148,7 @@ Candy.action({
 Add custom animations:
 
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     update: 'main',
     on: function(page, variables) {
@@ -170,7 +170,7 @@ Candy.action({
 Smooth page transitions:
 
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     update: 'main',
     on: function(page, variables) {
@@ -209,7 +209,7 @@ main.page-enter-active {
 Automatically scroll to top on navigation:
 
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     update: 'main',
     on: function(page, variables) {
@@ -229,7 +229,7 @@ Remember scroll position:
 ```javascript
 let scrollPositions = {}
 
-Candy.action({
+Odac.action({
   navigate: {
     update: 'main',
     on: function(page, variables) {
@@ -256,7 +256,7 @@ Candy.action({
 Scroll to specific element after navigation:
 
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     update: 'main',
     on: function(page, variables) {
@@ -282,10 +282,10 @@ Candy.action({
 Gracefully handle navigation errors:
 
 ```javascript
-// Override Candy.load to add error handling
-const originalLoad = Candy.load.bind(Candy)
+// Override odac.load to add error handling
+const originalLoad = odac.load.bind(Odac)
 
-Candy.load = function(url, callback, push) {
+odac.load = function(url, callback, push) {
   try {
     originalLoad(url, function(page, variables) {
       if (callback) callback(page, variables)
@@ -308,7 +308,7 @@ function loadWithRetry(url, maxRetries = 3) {
   
   function attempt() {
     attempts++
-    Candy.load(url, 
+    odac.load(url, 
       (page, vars) => {
         console.log('Success after', attempts, 'attempts')
       },
@@ -333,7 +333,7 @@ Prevent rapid navigation:
 ```javascript
 let navigationTimeout
 
-Candy.action({
+Odac.action({
   click: {
     'a[href^="/"]': function(e) {
       clearTimeout(navigationTimeout)
@@ -353,7 +353,7 @@ Prefetch pages on hover:
 ```javascript
 let prefetchCache = {}
 
-Candy.action({
+Odac.action({
   mouseover: {
     'a[href^="/"]': function() {
       const url = this.getAttribute('href')
@@ -362,7 +362,7 @@ Candy.action({
         // Prefetch the page
         fetch(url, {
           headers: {
-            'X-Candy': 'prefetch'
+            'X-Odac': 'prefetch'
           }
         }).then(response => response.text())
           .then(html => {
@@ -381,7 +381,7 @@ Candy.action({
 Track page views:
 
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     update: 'main',
     on: function(page, variables) {
@@ -407,7 +407,7 @@ Candy.action({
 Redux/Vuex integration:
 
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     update: 'main',
     on: function(page, variables) {
@@ -430,7 +430,7 @@ Test navigation logic:
 ```javascript
 describe('Navigation', () => {
   it('should update active nav on page change', () => {
-    Candy.action({
+    Odac.action({
       navigate: {
         update: 'main',
         on: (page) => {
@@ -440,7 +440,7 @@ describe('Navigation', () => {
     })
     
     // Simulate navigation
-    Candy.load('/about')
+    odac.load('/about')
     
     // Assert
     expect(document.querySelector('.nav-link.active').href)
@@ -463,7 +463,7 @@ describe('Navigation', () => {
 ### Dashboard Navigation
 
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     links: '.sidebar a, .breadcrumb a',
     update: {
@@ -482,7 +482,7 @@ Candy.action({
 ### E-commerce
 
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     update: {
       content: 'main',
@@ -499,7 +499,7 @@ Candy.action({
 ### Blog
 
 ```javascript
-Candy.action({
+Odac.action({
   navigate: {
     update: 'main',
     on: (page, vars) => {
@@ -516,4 +516,4 @@ Candy.action({
 
 - Learn about [Form Handling](../03-forms/01-form-handling.md)
 - Explore [API Requests](../04-api-requests/01-get-post.md)
-- Check [candy.js Overview](../01-overview/01-introduction.md)
+- Check [odac.js Overview](../01-overview/01-introduction.md)

package/docs/frontend/03-forms/01-form-handling.md

@@ -1,6 +1,6 @@
-# Form Handling with candy.js
+# Form Handling with odac.js
 
-Learn how to handle forms with automatic AJAX submission, CSRF protection, and validation in CandyPack.
+Learn how to handle forms with automatic AJAX submission, CSRF protection, and validation in Odac.
 
 ## Quick Start
 
@@ -14,14 +14,14 @@ Learn how to handle forms with automatic AJAX submission, CSRF protection, and v
 ```
 
 ```javascript
-Candy.form('#contact-form', function(data) {
+odac.form('#contact-form', function(data) {
   if (data.result.success) {
     alert('Form submitted successfully!')
   }
 })
 ```
 
-That's it! candy.js handles:
+That's it! odac.js handles:
 - ✅ AJAX submission
 - ✅ CSRF token (automatic)
 - ✅ Validation errors (auto-generated)
@@ -35,7 +35,7 @@ That's it! candy.js handles:
 ### Basic Usage
 
 ```javascript
-Candy.form('#my-form', function(data) {
+odac.form('#my-form', function(data) {
   console.log('Response:', data)
 })
 ```
@@ -43,7 +43,7 @@ Candy.form('#my-form', function(data) {
 ### With Options
 
 ```javascript
-Candy.form({
+odac.form({
   form: '#my-form',
   messages: true,  // Show error/success messages
   loading: function(percent) {
@@ -59,7 +59,7 @@ Candy.form({
 ### Redirect After Submit
 
 ```javascript
-Candy.form('#my-form', '/success-page')
+odac.form('#my-form', '/success-page')
 // Redirects to /success-page on success
 ```
 
@@ -75,17 +75,17 @@ If you want to control where errors appear, add error elements manually:
 
 ```html
 <input name="email" type="email">
-<span candy-form-error="email"></span>
+<span odac-form-error="email"></span>
 ```
 
-**If not present:** The system automatically creates `<span candy-form-error="email">` after the input field.
+**If not present:** The system automatically creates `<span odac-form-error="email">` after the input field.
 
 **If present:** The system uses your existing element and updates its content.
 
 ### Custom Error Display
 
 ```javascript
-Candy.form('#my-form', function(data) {
+odac.form('#my-form', function(data) {
   if (!data.result.success) {
     // Custom error handling
     Object.entries(data.errors).forEach(([field, message]) => {
@@ -99,7 +99,7 @@ Candy.form('#my-form', function(data) {
 
 ```css
 /* Error message */
-[candy-form-error] {
+[odac-form-error] {
   color: #ef4444;
   font-size: 0.875rem;
   margin-top: 0.25rem;
@@ -107,7 +107,7 @@ Candy.form('#my-form', function(data) {
 }
 
 /* Invalid input */
-input._candy_error {
+input._odac_error {
   border-color: #ef4444;
 }
 ```
@@ -126,18 +126,18 @@ If you want to control where success messages appear, add a success element manu
 <form id="my-form" action="/api/submit" method="POST">
   <!-- form fields -->
   <button type="submit">Submit</button>
-  <div candy-form-success></div>
+  <div odac-form-success></div>
 </form>
 ```
 
-**If not present:** The system automatically creates `<span candy-form-success>` at the end of the form.
+**If not present:** The system automatically creates `<span odac-form-success>` at the end of the form.
 
 **If present:** The system uses your existing element and updates its content.
 
 ### Custom Success Message
 
 ```javascript
-Candy.form('#my-form', function(data) {
+odac.form('#my-form', function(data) {
   if (data.result.success) {
     document.querySelector('#custom-message').innerHTML = 
       'Thank you! Your form has been submitted.'
@@ -157,7 +157,7 @@ Candy.form('#my-form', function(data) {
 ```
 
 ```javascript
-Candy.form('#upload-form', function(data) {
+odac.form('#upload-form', function(data) {
   if (data.result.success) {
     console.log('File uploaded:', data.result.filename)
   }
@@ -167,7 +167,7 @@ Candy.form('#upload-form', function(data) {
 ### Upload Progress
 
 ```javascript
-Candy.form({
+odac.form({
   form: '#upload-form',
   loading: function(percent) {
     document.querySelector('#progress').style.width = percent + '%'
@@ -189,7 +189,7 @@ Candy.form({
 ### Disable Messages
 
 ```javascript
-Candy.form({
+odac.form({
   form: '#my-form',
   messages: false  // Don't show automatic messages
 }, function(data) {
@@ -200,7 +200,7 @@ Candy.form({
 ### Disable Specific Messages
 
 ```javascript
-Candy.form({
+odac.form({
   form: '#my-form',
   messages: ['error']  // Only show errors, not success
 }, function(data) {
@@ -211,7 +211,7 @@ Candy.form({
 ### Form Reset
 
 ```javascript
-Candy.form('#my-form', function(data) {
+odac.form('#my-form', function(data) {
   if (data.result.success) {
     // Reset the form
     document.querySelector('#my-form').reset()
@@ -229,7 +229,7 @@ document.querySelector('#my-form').addEventListener('submit', function(e) {
   }
 })
 
-Candy.form('#my-form', function(data) {
+odac.form('#my-form', function(data) {
   console.log('Submitted!')
 })
 ```
@@ -240,9 +240,9 @@ Candy.form('#my-form', function(data) {
 
 ```javascript
 // controller/post/contact.js
-module.exports = async function(Candy) {
-  const email = await Candy.Request.request('email')
-  const message = await Candy.Request.request('message')
+module.exports = async function(Odac) {
+  const email = await odac.Request.request('email')
+  const message = await odac.Request.request('message')
   
   // Validation
   const errors = {}
@@ -272,7 +272,7 @@ module.exports = async function(Candy) {
 
 ```javascript
 // route/www.js
-Candy.Route.post('/api/contact', 'contact')
+odac.Route.post('/api/contact', 'contact')
 ```
 
 ## Validation
@@ -292,8 +292,8 @@ Use HTML5 validation:
 Always validate on the server:
 
 ```javascript
-module.exports = async function(Candy) {
-  const email = await Candy.Request.request('email')
+module.exports = async function(Odac) {
+  const email = await odac.Request.request('email')
   
   const errors = {}
   
@@ -336,7 +336,7 @@ module.exports = async function(Candy) {
 **Note:** Error and success elements are auto-generated. Add them manually only if you need custom positioning or styling.
 
 ```javascript
-Candy.form('#contact-form', function(data) {
+odac.form('#contact-form', function(data) {
   if (data.result.success) {
     document.querySelector('#contact-form').reset()
   }
@@ -354,7 +354,7 @@ Candy.form('#contact-form', function(data) {
 ```
 
 ```javascript
-Candy.form('#login-form', function(data) {
+odac.form('#login-form', function(data) {
   if (data.result.success) {
     // Redirect to dashboard
     window.location.href = '/dashboard'
@@ -379,7 +379,7 @@ Candy.form('#login-form', function(data) {
 ```html
 <div class="form-group">
   <input name="email" type="email" required>
-  <span candy-form-error="email" class="error-message"></span>
+  <span odac-form-error="email" class="error-message"></span>
 </div>
 ```
 
@@ -396,7 +396,7 @@ Candy.form('#login-form', function(data) {
 
 ### Form Not Submitting
 
-- Check that `Candy.form()` is called after DOM is ready
+- Check that `Odac.form()` is called after DOM is ready
 - Verify the form selector is correct
 - Check browser console for errors
 
@@ -405,7 +405,7 @@ Candy.form('#login-form', function(data) {
 - Errors are automatically created - no manual elements needed
 - Check that server returns errors in correct format: `{result: {success: false}, errors: {fieldName: 'message'}}`
 - Verify `messages` option is not set to `false`
-- If using custom error elements, ensure `candy-form-error` attributes match field names exactly
+- If using custom error elements, ensure `odac-form-error` attributes match field names exactly
 
 ### CSRF Token Errors