jac-client 0.2.0__py3-none-any.whl → 0.2.3__py3-none-any.whl

jac_client/docs/guide-example/step-08-walkers.md

@@ -1,12 +1,12 @@
 # Step 8: Backend with Walkers
 
-> **💡 Quick Tip:** Each step has two parts. **Part 1** shows you what to build. **Part 2** explains why it works. Want to just build? Skip all Part 2 sections!
+> ** Quick Tip:** Each step has two parts. **Part 1** shows you what to build. **Part 2** explains why it works. Want to just build? Skip all Part 2 sections!
 
 In this step, you'll add a **real backend** to your app using walkers - so your todos are stored on a server!
 
 ---
 
-## 🏗️ Part 1: Building the App
+##  Part 1: Building the App
 
 ### Step 8.1: Define the Todo Node
 
@@ -231,15 +231,15 @@ When rendering todos, use `_jac_id` instead of custom id:
 1. Add some todos
 2. Check/uncheck them
 3. Delete some
-4. **Refresh the page** - your todos persist!  🎉
+4. **Refresh the page** - your todos persist!
 
 ---
 
-**⏭️ Want to skip the theory?** Jump to [Step 9: Authentication](./step-09-authentication.md)
+**⏭ Want to skip the theory?** Jump to [Step 9: Authentication](./step-09-authentication.md)
 
 ---
 
-## 💡 Part 2: Understanding the Concepts
+##  Part 2: Understanding the Concepts
 
 ### What Are Walkers?
 
@@ -422,28 +422,28 @@ useEffect(lambda -> None {
 
 ---
 
-## ✅ What You've Learned
+##  What You've Learned
 
-- ✅ What walkers are (backend functions)
-- ✅ How to define data models with nodes
-- ✅ Creating walkers for CRUD operations
-- ✅ Calling walkers from frontend with `spawn`
-- ✅ Graph traversal (`-->`, `` `?Node ``)
-- ✅ Creating node connections (`++>`)
-- ✅ Reporting data to frontend
-- ✅ Using `_jac_id` for node references
-- ✅ Data persistence on the server
+-  What walkers are (backend functions)
+-  How to define data models with nodes
+-  Creating walkers for CRUD operations
+-  Calling walkers from frontend with `spawn`
+-  Graph traversal (`-->`, `` `?Node ``)
+-  Creating node connections (`++>`)
+-  Reporting data to frontend
+-  Using `_jac_id` for node references
+-  Data persistence on the server
 
 ---
 
-## 🐛 Common Issues
+##  Common Issues
 
 ### Issue: Walker not found
 
 **Check:** Is the walker defined OUTSIDE the `cl { }` block?
 
 ```jac
-# ✅ Correct
+#  Correct
 walker read_todos {
     # ...
 }
@@ -452,7 +452,7 @@ cl {
     # frontend code
 }
 
-# ❌ Wrong
+#  Wrong
 cl {
     walker read_todos {  # Can't define walkers in frontend!
         # ...
@@ -465,12 +465,12 @@ cl {
 **Check:** Did you call `report` in your walker?
 
 ```jac
-# ❌ Wrong - no report
+#  Wrong - no report
 can read with `root entry {
     visit [-->(`?Todo)];
 }
 
-# ✅ Correct - report in Todo entry
+#  Correct - report in Todo entry
 can report_todos with Todo entry {
     report here;
 }
@@ -497,7 +497,7 @@ if result.reports and result.reports.length > 0 {
 
 ---
 
-## 🎯 Quick Exercise
+##  Quick Exercise
 
 Try adding a walker to clear all completed todos:
 
@@ -525,10 +525,10 @@ async def clearCompleted() -> None {
 
 ---
 
-## ➡️ Next Step
+##  Next Step
 
 Excellent! Your app now has a real backend. But there's a problem: **everyone can see everyone's todos!**
 
 In the next step, we'll add **authentication** to make your app secure and private!
 
-👉 **[Continue to Step 9: Authentication](./step-09-authentication.md)**
+ **[Continue to Step 9: Authentication](./step-09-authentication.md)**

jac_client/docs/guide-example/step-09-authentication.md

@@ -1,12 +1,12 @@
 # Step 9: Adding Authentication
 
-> **💡 Quick Tip:** Each step has two parts. **Part 1** shows you what to build. **Part 2** explains why it works. Want to just build? Skip all Part 2 sections!
+> ** Quick Tip:** Each step has two parts. **Part 1** shows you what to build. **Part 2** explains why it works. Want to just build? Skip all Part 2 sections!
 
 In this step, you'll add user authentication so each person has their own private todos!
 
 ---
 
-## 🏗️ Part 1: Building the App
+##  Part 1: Building the App
 
 ### Step 9.1: Import Authentication Functions
 
@@ -313,11 +313,11 @@ def TodosPage() -> any {
 
 ---
 
-**⏭️ Want to skip the theory?** Jump to [Step 10: Routing](./step-10-routing.md)
+**⏭ Want to skip the theory?** Jump to [Step 10: Routing](./step-10-routing.md)
 
 ---
 
-## 💡 Part 2: Understanding the Concepts
+##  Part 2: Understanding the Concepts
 
 ### What is Authentication?
 
@@ -506,21 +506,21 @@ await jacLogin("alice", "password123");
 
 ---
 
-## ✅ What You've Learned
+##  What You've Learned
 
-- ✅ What authentication is and why it's important
-- ✅ Using `jacSignup` to create accounts
-- ✅ Using `jacLogin` to log users in
-- ✅ Using `jacLogout` to log users out
-- ✅ Using `jacIsLoggedIn` to check auth status
-- ✅ Creating login and signup forms
-- ✅ Handling form submission
-- ✅ Protecting pages with auth checks
-- ✅ User isolation (each user sees only their data)
+-  What authentication is and why it's important
+-  Using `jacSignup` to create accounts
+-  Using `jacLogin` to log users in
+-  Using `jacLogout` to log users out
+-  Using `jacIsLoggedIn` to check auth status
+-  Creating login and signup forms
+-  Handling form submission
+-  Protecting pages with auth checks
+-  User isolation (each user sees only their data)
 
 ---
 
-## 🐛 Common Issues
+##  Common Issues
 
 ### Issue: "Signup failed"
 
@@ -552,7 +552,7 @@ await jacLogin("alice", "password123");
 
 ---
 
-## 🎯 Quick Exercise
+##  Quick Exercise
 
 Try adding a "Remember me" message:
 
@@ -577,10 +577,10 @@ def LoginPage() -> any {
 
 ---
 
-## ➡️ Next Step
+##  Next Step
 
 Great! You now have authentication, but you're still showing only one page at a time.
 
 In the next step, we'll add **routing** so users can navigate between login, signup, and todos pages!
 
-👉 **[Continue to Step 10: Routing](./step-10-routing.md)**
+ **[Continue to Step 10: Routing](./step-10-routing.md)**

jac_client/docs/guide-example/step-10-routing.md

@@ -1,12 +1,12 @@
 # Step 10: Adding Routing
 
-> **💡 Quick Tip:** Each step has two parts. **Part 1** shows you what to build. **Part 2** explains why it works. Want to just build? Skip all Part 2 sections!
+> ** Quick Tip:** Each step has two parts. **Part 1** shows you what to build. **Part 2** explains why it works. Want to just build? Skip all Part 2 sections!
 
 In this step, you'll add multiple pages to your app so users can navigate between login, signup, and todos!
 
 ---
 
-## 🏗️ Part 1: Building the App
+##  Part 1: Building the App
 
 ### Step 10.1: Import Routing Components
 
@@ -237,11 +237,11 @@ def app() -> any {
 
 ---
 
-**⏭️ Want to skip the theory?** Jump to [Step 11: Final Integration](./step-11-final.md)
+**⏭ Want to skip the theory?** Jump to [Step 11: Final Integration](./step-11-final.md)
 
 ---
 
-## 💡 Part 2: Understanding the Concepts
+##  Part 2: Understanding the Concepts
 
 ### What is Routing?
 
@@ -319,10 +319,10 @@ def login():
 **vs regular anchor tag:**
 
 ```jac
-# ❌ Wrong - causes page reload
+#  Wrong - causes page reload
 <a href="/login">Go to Login</a>
 
-# ✅ Correct - no page reload
+#  Correct - no page reload
 <Link to="/login">Go to Login</Link>
 ```
 
@@ -463,19 +463,19 @@ def handleLogout() -> None {
 
 ---
 
-## ✅ What You've Learned
+##  What You've Learned
 
-- ✅ What client-side routing is
-- ✅ Setting up Router, Routes, and Route
-- ✅ Creating navigation with Link
-- ✅ Programmatic navigation with Navigate
-- ✅ Protected routes with authentication checks
-- ✅ Conditional navigation based on auth status
-- ✅ Common routing patterns
+-  What client-side routing is
+-  Setting up Router, Routes, and Route
+-  Creating navigation with Link
+-  Programmatic navigation with Navigate
+-  Protected routes with authentication checks
+-  Conditional navigation based on auth status
+-  Common routing patterns
 
 ---
 
-## 🐛 Common Issues
+##  Common Issues
 
 ### Issue: Links don't work
 
@@ -489,10 +489,10 @@ def handleLogout() -> None {
 **Cause:** Using `<a href="">` instead of `<Link to="">`
 
 ```jac
-# ❌ Wrong
+#  Wrong
 <a href="/login">Login</a>
 
-# ✅ Correct
+#  Correct
 <Link to="/login">Login</Link>
 ```
 
@@ -511,7 +511,7 @@ def handleLogout() -> None {
 
 ---
 
-## 🎯 Quick Exercise
+##  Quick Exercise
 
 Try adding a 404 page for unknown routes:
 
@@ -532,9 +532,8 @@ def NotFoundPage() -> any {
 
 ---
 
-## ➡️ Next Step
+##  Next Step
 
 Congratulations! You've learned all the key concepts. Now let's put everything together into the **complete, final app**!
 
-👉 **[Continue to Step 11: Final Integration](./step-11-final.md)**
-
+ **[Continue to Step 11: Final Integration](./step-11-final.md)**

jac_client/docs/guide-example/step-11-final.md

@@ -1,12 +1,12 @@
 # Step 11: Final Integration - Complete App
 
-> **💡 Quick Tip:** Each step has two parts. **Part 1** shows you what to build. **Part 2** explains why it works. Want to just build? Skip all Part 2 sections!
+> ** Quick Tip:** Each step has two parts. **Part 1** shows you what to build. **Part 2** explains why it works. Want to just build? Skip all Part 2 sections!
 
-Congratulations! 🎉 In this final step, you'll see the complete, production-ready todo application with all features integrated!
+Congratulations!  In this final step, you'll see the complete, production-ready todo application with all features integrated!
 
 ---
 
-## 🏗️ Part 1: The Complete App
+##  Part 1: The Complete App
 
 ### Complete `app.jac` File
 
@@ -712,22 +712,22 @@ cl {
 
 ---
 
-**🎉 You did it!** You've built a complete full-stack app. The rest of this page explains what you built and what to do next.
+** You did it!** You've built a complete full-stack app. The rest of this page explains what you built and what to do next.
 
 ---
 
-## 💡 Part 2: What You Built
+##  Part 2: What You Built
 
 ### Features Checklist
 
-✅ **Authentication:**
+ **Authentication:**
 - User signup
 - User login
 - Logout
 - Session persistence
 - Protected routes
 
-✅ **Todo Management:**
+ **Todo Management:**
 - Create todos
 - Mark as complete/incomplete
 - Delete todos
@@ -735,7 +735,7 @@ cl {
 - Item counter
 - Empty state handling
 
-✅ **UI/UX:**
+ **UI/UX:**
 - Responsive design
 - Modern styling
 - Form validation
@@ -743,7 +743,7 @@ cl {
 - Loading states
 - Smooth navigation
 
-✅ **Backend:**
+ **Backend:**
 - Data persistence with walkers
 - User isolation (each user sees only their data)
 - Graph-based data structure
@@ -779,7 +779,7 @@ Your entire app:
     └── Routes (navigation)
 ```
 
-That's it! Just one file! 🚀
+That's it! Just one file!
 
 ### Code Organization
 
@@ -800,7 +800,7 @@ app.jac
 
 ---
 
-## 🚀 What's Next?
+##  What's Next?
 
 You've completed the tutorial! Here are some ideas to continue learning:
 
@@ -885,7 +885,7 @@ Apply what you learned:
 
 ---
 
-## 📚 Resources
+##  Resources
 
 **Official Documentation:**
 - [Jac Documentation](https://www.jac-lang.org)
@@ -905,21 +905,21 @@ Apply what you learned:
 
 ---
 
-## 🎓 What You Learned
+##  What You Learned
 
 Looking back at all 11 steps:
 
-1. ✅ Project setup and structure
-2. ✅ Components and props
-3. ✅ Styling with inline CSS
-4. ✅ Building complex UIs
-5. ✅ State management with useState
-6. ✅ Event handlers
-7. ✅ Side effects with useEffect
-8. ✅ Backend with walkers and nodes
-9. ✅ User authentication
-10. ✅ Client-side routing
-11. ✅ Complete full-stack integration
+1.  Project setup and structure
+2.  Components and props
+3.  Styling with inline CSS
+4.  Building complex UIs
+5.  State management with useState
+6.  Event handlers
+7.  Side effects with useEffect
+8.  Backend with walkers and nodes
+9.  User authentication
+10.  Client-side routing
+11.  Complete full-stack integration
 
 **Key concepts mastered:**
 - Full-stack development in one language
@@ -934,23 +934,23 @@ Looking back at all 11 steps:
 
 ---
 
-## 🎉 Congratulations!
+##  Congratulations!
 
 You built a **complete, production-ready full-stack application** from scratch!
 
 **What makes this special:**
-- ✅ **735 lines** of code (compared to 2000+ in traditional stacks)
-- ✅ **One language** (compared to 3-4: JavaScript, Python, SQL, HTML/CSS)
-- ✅ **One file** (compared to dozens of files)
-- ✅ **Zero configuration** (no webpack, babel, etc.)
-- ✅ **Built-in auth** (no OAuth setup needed)
-- ✅ **Automatic backend** (no Express/Flask setup)
+-  **735 lines** of code (compared to 2000+ in traditional stacks)
+-  **One language** (compared to 3-4: JavaScript, Python, SQL, HTML/CSS)
+-  **One file** (compared to dozens of files)
+-  **Zero configuration** (no webpack, babel, etc.)
+-  **Built-in auth** (no OAuth setup needed)
+-  **Automatic backend** (no Express/Flask setup)
 
-You're now ready to build amazing full-stack applications with Jac! 🚀
+You're now ready to build amazing full-stack applications with Jac!
 
 ---
 
-## 💬 Share Your Success!
+##  Share Your Success!
 
 Built something cool? Share it:
 - Tag #JacLang on social media
@@ -960,5 +960,4 @@ Built something cool? Share it:
 
 **Thank you for completing this tutorial!**
 
-Happy coding with Jac! 🎊
-
+Happy coding with Jac!

jac_client/docs/imports.md

@@ -4,7 +4,7 @@ Learn how to import third-party libraries, other Jac files, and JavaScript modul
 
 ---
 
-## 📚 Table of Contents
+##  Table of Contents
 
 - [Importing Jac-Client Utilities](#importing-jac-client-utilities)
 - [Working with Third-Party Node Modules](#working-with-third-party-node-modules)
@@ -677,7 +677,7 @@ cl {
         return <div>
             <h1>{count} {pluralWord}</h1>
             <Rotate>
-                <span style={{"fontSize": "48px"}}>😂</span>
+                <span style={{"fontSize": "48px"}}></span>
             </Rotate>
         </div>;
     }
@@ -983,7 +983,7 @@ cl def ValidationForm() -> any {
 ### 1. Organize Imports
 
 ```jac
-# ✅ Good: Group imports logically
+#  Good: Group imports logically
 # Third-party libraries
 cl import from antd {
     Button,
@@ -1138,5 +1138,4 @@ Type errors with imported functions
 - **JavaScript Files**: Import with `cl import from .filename`
 - **Best Practices**: Organize imports, import only what you need, document exports
 
-Imports in Jac make it easy to use third-party libraries and organize your code! 🚀
-
+Imports in Jac make it easy to use third-party libraries and organize your code!

jac_client/docs/lifecycle-hooks.md

@@ -4,7 +4,7 @@ Learn how to use React's `useEffect` and `useState` hooks to manage component st
 
 ---
 
-## 📚 Table of Contents
+##  Table of Contents
 
 - [What are Lifecycle Hooks?](#what-are-lifecycle-hooks)
 - [React Hooks (Recommended)](#react-hooks-recommended)
@@ -424,7 +424,7 @@ cl {
             "padding": "24px",
             "fontFamily": "system-ui, -apple-system, sans-serif"
         }}>
-            <h1 style={{"textAlign": "center"}}>📝 My Todo App</h1>
+            <h1 style={{"textAlign": "center"}}> My Todo App</h1>
 
             # Add todo form
             <div style={{"display": "flex", "gap": "8px", "marginBottom": "24px"}}>
@@ -546,17 +546,17 @@ cl {
 Be explicit about what your effect depends on:
 
 ```jac
-# ✅ Good: Empty array for mount-only effects
+#  Good: Empty array for mount-only effects
 useEffect(lambda -> None {
     loadInitialData();
 }, []);
 
-# ✅ Good: Specify dependencies
+#  Good: Specify dependencies
 useEffect(lambda -> None {
     console.log("Count changed:", count);
 }, [count]);
 
-# ⚠️ Warning: No dependency array runs on every render
+#  Warning: No dependency array runs on every render
 useEffect(lambda -> None {
     console.log("Runs on every render!");
 });
@@ -567,7 +567,7 @@ useEffect(lambda -> None {
 Always handle async operations with proper error handling:
 
 ```jac
-# ✅ Good: Proper async handling
+#  Good: Proper async handling
 useEffect(lambda -> None {
     async def loadData() -> None {
         try {
@@ -587,7 +587,7 @@ useEffect(lambda -> None {
 Always clean up event listeners, timers, and subscriptions:
 
 ```jac
-# ✅ Good: Cleanup function removes event listener
+#  Good: Cleanup function removes event listener
 useEffect(lambda -> any {
     def handleResize() -> None {
         setWidth(window.innerWidth);
@@ -606,7 +606,7 @@ useEffect(lambda -> any {
 Show loading indicators while data is being fetched:
 
 ```jac
-# ✅ Good: Clear loading states
+#  Good: Clear loading states
 def Component() -> any {
     let [data, setData] = useState(None);
     let [loading, setLoading] = useState(True);
@@ -638,7 +638,7 @@ def Component() -> any {
 Each effect should have a single responsibility:
 
 ```jac
-# ✅ Good: Separate effects for separate concerns
+#  Good: Separate effects for separate concerns
 def Component() -> any {
     useEffect(lambda -> None {
         loadData();  # Data loading
@@ -661,14 +661,14 @@ def Component() -> any {
 Be careful with closures capturing old state values:
 
 ```jac
-# ❌ Avoid: Stale closure problem
+#  Avoid: Stale closure problem
 useEffect(lambda -> None {
     setInterval(lambda -> None {
         setCount(count + 1);  # count is stale!
     }, 1000);
 }, []);
 
-# ✅ Good: Use functional update
+#  Good: Use functional update
 useEffect(lambda -> any {
     intervalId = setInterval(lambda -> None {
         setCount(lambda prev: int -> int { return prev + 1; });
@@ -690,7 +690,7 @@ useEffect(lambda -> any {
 - **Cleanup**: Return a cleanup function for subscriptions, timers, and listeners
 - **Best Practices**: Handle errors, use loading states, keep effects focused
 
-React hooks provide a powerful and standard way to manage component lifecycle! 🎯
+React hooks provide a powerful and standard way to manage component lifecycle!
 
 ---
 
@@ -771,4 +771,3 @@ useEffect(lambda -> None {
     console.log("Count:", count);
 }, [count]);
 ```
-