jac-client 0.2.0__py3-none-any.whl

jac_client-0.2.0.dist-info/METADATA

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: jac-client
+Version: 0.2.0
+Summary: 
+Author: Jason Mars
+Author-email: jason@mars.ninja
+Requires-Python: >=3.12.0,<4.0.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: jaclang (==0.9.0)
+Description-Content-Type: text/markdown
+
+# Jac Client
+
+Build full-stack web applications with Jac - one language for frontend and backend.
+
+Jac Client enables you to write React-like components, manage state, and build interactive UIs all in Jac. No need for separate frontend frameworks, HTTP clients, or complex build configurations.
+
+---
+
+## ✨ Features
+
+- **Single Language**: Write frontend and backend in Jac
+- **No HTTP Client**: Use `jacSpawn()` instead of fetch/axios
+- **React Hooks**: Use standard React `useState` and `useEffect` hooks
+- **Component-Based**: Build reusable UI components with JSX
+- **Graph Database**: Built-in graph data model eliminates need for SQL/NoSQL
+- **Type Safety**: Type checking across frontend and backend
+- **Vite-Powered**: Optimized production bundles with Vite
+
+---
+
+## 🚀 Quick Start
+
+### Installation
+
+```bash
+pip install jac-client
+```
+
+### Create a New App
+
+```bash
+jac create_jac_app my-app
+cd my-app
+jac serve app.jac
+```
+
+Visit `http://localhost:8000/page/app` to see your app!
+
+---
+
+## 📚 Documentation
+
+For detailed guides and tutorials, see the **[docs folder](jac_client/docs/)**:
+
+- **[Getting Started Guide](jac_client/docs/README.md)** - Complete beginner's guide
+- **[Routing](jac_client/docs/routing.md)** - Multi-page applications with declarative routing (`<Router>`, `<Routes>`, `<Route>`)
+- **[Lifecycle Hooks](jac_client/docs/lifecycle-hooks.md)** - Using React hooks (`useState`, `useEffect`)
+- **[Advanced State](jac_client/docs/advanced-state.md)** - Managing complex state with React hooks
+- **[Imports](jac_client/docs/imports.md)** - Importing third-party libraries (React, Ant Design, Lodash), Jac files, and JavaScript modules
+
+---
+
+## 💡 Example
+
+### Simple Counter with React Hooks
+
+```jac
+cl import from react { useState, useEffect }
+
+cl {
+    def Counter() -> any {
+        let [count, setCount] = useState(0);
+
+        useEffect(lambda -> None {
+            console.log("Count changed:", count);
+        }, [count]);
+
+        return <div>
+            <h1>Count: {count}</h1>
+            <button onClick={lambda e: any -> None {
+                setCount(count + 1);
+            }}>
+                Increment
+            </button>
+        </div>;
+    }
+
+    def app() -> any {
+        return Counter();
+    }
+}
+```
+
+### Full-Stack Todo App
+
+```jac
+cl import from react { useState, useEffect }
+cl import from '@jac-client/utils' { jacSpawn }
+
+# Backend: Jac nodes and walkers
+node Todo {
+    has text: str;
+    has done: bool = False;
+}
+
+walker create_todo {
+    has text: str;
+    can create with `root entry {
+        new_todo = here ++> Todo(text=self.text);
+        report new_todo;
+    }
+}
+
+walker read_todos {
+    can read with `root entry {
+        visit [-->(`?Todo)];
+    }
+}
+
+# Frontend: React component
+cl {
+    def app() -> any {
+        let [todos, setTodos] = useState([]);
+
+        useEffect(lambda -> None {
+            async def loadTodos() -> None {
+                result = await jacSpawn("read_todos", "", {});
+                setTodos(result.reports);
+            }
+            loadTodos();
+        }, []);
+
+        return <div>
+            <h1>My Todos</h1>
+            {todos.map(lambda todo: any -> any {
+                return <div key={todo._jac_id}>{todo.text}</div>;
+            })}
+        </div>;
+    }
+}
+```
+
+---
+
+## 🔧 Requirements
+
+- Python: 3.12+
+- Node.js: For npm and Vite
+- Jac Language: `jaclang` (installed automatically)
+
+---
+
+## 🛠️ How It Works
+
+Jac Client is a plugin that:
+1. Compiles your `.jac` client code to JavaScript
+2. Bundles dependencies with Vite for optimal performance
+3. Provides a runtime for reactive state and components
+4. Integrates seamlessly with Jac's backend graph operations
+
+---
+
+## 📖 Learn More
+
+- **Full Documentation**: See [docs/](jac_client/docs/) for comprehensive guides
+- **Examples**: Check `jac_client/examples/` for working examples
+- **Issues**: Report bugs on [GitHub Issues](https://github.com/Jaseci-Labs/jaseci/issues)
+
+---
+
+## 📄 License
+
+MIT License - see [LICENSE](../LICENSE) file.
+
+---
+
+**Happy coding with Jac!** 🎉
+

jac_client-0.2.0.dist-info/RECORD

@@ -0,0 +1,72 @@
+jac_client/docs/README.md,sha256=HV00SWr2tvfjzoB4fhY6UbfAwTPsQ1kTelkjIdBt_g8,17173
+jac_client/docs/advanced-state.md,sha256=RNF5w2A8_ElBdfUFBjqWXqLG7pTVhCHP5Ujhuf9MCys,35465
+jac_client/docs/assets/pipe_line.png,sha256=agSseYhL8rNX-cxlqlfbBOuhtq_iGnujNx6oQufl33s,70639
+jac_client/docs/guide-example/intro.md,sha256=BftfRNckYMk4GDvEvFprJM6C3shR_Ub6wf07pXpT9AQ,4630
+jac_client/docs/guide-example/step-01-setup.md,sha256=aG6fbQlrAXpKaciwMDPCVTG-MAZuJBu8JZwZ1_SSoOc,5374
+jac_client/docs/guide-example/step-02-components.md,sha256=xD2eY59Wn100-o71yfrSvTSqud_mVSoMnD1hSYVzNNg,8710
+jac_client/docs/guide-example/step-03-styling.md,sha256=O1k710uKVaFrLijVxaLHMOBOQK7DpH3FvYKgBm-Os0k,10717
+jac_client/docs/guide-example/step-04-todo-ui.md,sha256=Di9yF9k5ch7LFha8Q3DCDf8PI8Dzps85zpnI1uZQJUk,12039
+jac_client/docs/guide-example/step-05-local-state.md,sha256=k5a2FS6gS0JxsA2_rXQ-PJzYKZms9k11TRH5PVqfAkI,12956
+jac_client/docs/guide-example/step-06-events.md,sha256=T7cUedmD-nNluSRuQa9VBYTybTWgfP2Xfs_lQPzztQM,18596
+jac_client/docs/guide-example/step-07-effects.md,sha256=wSj64yqPSlye7oilW52t-BM5sTAh2nshmwRzbwuZi50,10135
+jac_client/docs/guide-example/step-08-walkers.md,sha256=D8ERSQXjihOMj7neanvX1stihJdpEsQZMAa0Sm3ZvUg,10564
+jac_client/docs/guide-example/step-09-authentication.md,sha256=CH0zkXONlEFlPs3xTyA-F7kDOML6E0OGvx1liWSTrhs,14295
+jac_client/docs/guide-example/step-10-routing.md,sha256=PswR89r-0n3LkoyE4zIl2mDupfFntJ1Teo7Q5GJbxtU,11813
+jac_client/docs/guide-example/step-11-final.md,sha256=deSEjhXxTBW_joiNrQM-Ad8qzVEwUiAS_WcOvVzCeyQ,28087
+jac_client/docs/imports.md,sha256=WQCiYR5jwWZelz6d5JwsLSHUKGbHg23mPDkREdInBiw,25709
+jac_client/docs/lifecycle-hooks.md,sha256=MU2aRD-EbGynjW-qe3jrN82dtebfiLd5uepP-14i6Xc,19494
+jac_client/docs/routing.md,sha256=yDQfyCWUhMDwyt7r8pZyCwj-TSXnZdl21BQazIcWFdw,17248
+jac_client/examples/basic/.babelrc,sha256=hbksHBMOJhU8iQeWqMk9fBu1Ym5NiR1AxgbBBdwnvW8,131
+jac_client/examples/basic/README.md,sha256=Ra90lVRm62Xnvd2j1cRewMZr_qKLQDxuRTq4-r2zU2g,188
+jac_client/examples/basic/app.jac,sha256=Ytf4UrWHGPtayG0QddOyiy_60tneP_eFLzQfaZkaSdY,433
+jac_client/examples/basic/package.json,sha256=jocBFTSfVdlfBNGdUgIfhZx0YuxVYcS49j368JI594M,656
+jac_client/examples/basic/vite.config.js,sha256=Fw_3OJilwEKwNo6nCpWyk2Tdgmx3BeN7QKRpXIM3lfk,671
+jac_client/examples/basic-auth/.babelrc,sha256=hbksHBMOJhU8iQeWqMk9fBu1Ym5NiR1AxgbBBdwnvW8,131
+jac_client/examples/basic-auth/README.md,sha256=aLI6d9PFhWQ5otE2ibYLia9pCCTzQBRl_snHlWFDgvw,192
+jac_client/examples/basic-auth/app.jac,sha256=aLu-1B8oISgDj_1FnwWCcfs7ZQkjhgWH2uM0qTaCytQ,12173
+jac_client/examples/basic-auth/package.json,sha256=un_qE_dVfFNOSgiMfqOujHTgVsHmte6aho5F8gEi-9Q,664
+jac_client/examples/basic-auth/vite.config.js,sha256=Fw_3OJilwEKwNo6nCpWyk2Tdgmx3BeN7QKRpXIM3lfk,671
+jac_client/examples/basic-auth-with-router/.babelrc,sha256=hbksHBMOJhU8iQeWqMk9fBu1Ym5NiR1AxgbBBdwnvW8,131
+jac_client/examples/basic-auth-with-router/README.md,sha256=rYvgGTT_PzzH_Whg-wLLI0aIj06VB2ZFCbnSTleNN7E,1824
+jac_client/examples/basic-auth-with-router/app.jac,sha256=-e5FLlFZf4pddSrNmitlhtpv5_z9wkdcnxIc2RagoNg,15079
+jac_client/examples/basic-auth-with-router/package.json,sha256=0jl9pUaXilbxKviDdBO_bCT6tXevMyP6RT17DlVmap4,723
+jac_client/examples/basic-auth-with-router/vite.config.js,sha256=Fw_3OJilwEKwNo6nCpWyk2Tdgmx3BeN7QKRpXIM3lfk,671
+jac_client/examples/basic-full-stack/.babelrc,sha256=hbksHBMOJhU8iQeWqMk9fBu1Ym5NiR1AxgbBBdwnvW8,131
+jac_client/examples/basic-full-stack/README.md,sha256=qEFUx5zPYk2OYi9XOpPBbE9oWyqudHu6YXTkcE35QPA,200
+jac_client/examples/basic-full-stack/app.jac,sha256=T2DbREtr7AaWskTIvvmrl6PCAtxclXwXhxity65I-6M,12080
+jac_client/examples/basic-full-stack/package.json,sha256=mBnqM2BG2GP7A7yRh7O_idRoCU2psojF8TD3rBzJ65c,710
+jac_client/examples/basic-full-stack/vite.config.js,sha256=Fw_3OJilwEKwNo6nCpWyk2Tdgmx3BeN7QKRpXIM3lfk,671
+jac_client/examples/full-stack-with-auth/.babelrc,sha256=hbksHBMOJhU8iQeWqMk9fBu1Ym5NiR1AxgbBBdwnvW8,131
+jac_client/examples/full-stack-with-auth/README.md,sha256=lQL3mQIxxHSujm0-xN95D-lh_7VfS94BmKnk1w30CLE,202
+jac_client/examples/full-stack-with-auth/app.jac,sha256=wPgxS5ag9BAU6as5-iDiXOZFVXFlcKldv8hyrfGj2Ms,22518
+jac_client/examples/full-stack-with-auth/package.json,sha256=xI-CNLFet0hqws_QelPZitVTnQTZHTXA70QcPjZXn9g,719
+jac_client/examples/full-stack-with-auth/vite.config.js,sha256=Hs7wgen2DoKvHfge2bg91H45UvzgfwzC45QRRYto73Q,711
+jac_client/examples/little-x/app.jac,sha256=NueM8h35Bvf-hXL-kyeZ01-HAL7xZxUxrpHR99ASkhM,16760
+jac_client/examples/little-x/package.json,sha256=XaXpijPuRDojT-yQFJwkaopDgqMiriepqEk0LsFQ-cU,521
+jac_client/examples/little-x/submit-button.jac,sha256=ByyRpDDN49RxoF8k7TC0r1mgoKAwwdlpo6wiiTE7p_4,324
+jac_client/examples/with-router/.babelrc,sha256=hbksHBMOJhU8iQeWqMk9fBu1Ym5NiR1AxgbBBdwnvW8,131
+jac_client/examples/with-router/README.md,sha256=Vj66hInHSqvv_5wxJlaH-fsvuBfwKd-qHoZFz53eqUs,189
+jac_client/examples/with-router/app.jac,sha256=nbnFhgxapgp9FSdc_fYy24KKl93iiy7N1GS5GEF1L0c,8671
+jac_client/examples/with-router/package.json,sha256=k8KnRIWgCrmRvmJUUB0dtG45qJFYBb-wI16w4cwrJPU,691
+jac_client/examples/with-router/vite.config.js,sha256=Fw_3OJilwEKwNo6nCpWyk2Tdgmx3BeN7QKRpXIM3lfk,671
+jac_client/plugin/cli.py,sha256=xaRp5k3OEdHeyLzrsDqk1UBuoBUmhqvVtGaofFYF-2A,7836
+jac_client/plugin/client.py,sha256=wpdp9H3LZG3Z5Ax4T23JTvjQGguLat523XhiPpK2qQ8,2751
+jac_client/plugin/client_runtime.jac,sha256=wDfckQTRSzlOZ9NwUg7pb7ljPb0tCf2e_-OtczK3uRQ,7613
+jac_client/plugin/vite_client_bundle.py,sha256=UMdsL2_YmtmPj9gVnGKbvjrNoi_eSEaquyaBDieB0Wk,13390
+jac_client/tests/__init__.py,sha256=zleq_UtH4HBbp9SSkkqtaLd1tvm5F3QfXHEffXpxxQo,37
+jac_client/tests/fixtures/basic-app/app.jac,sha256=nTPZ3Cc5pPAEncRfrfo1Z2LAyz6DVgGdB_uUW7W4b8Q,437
+jac_client/tests/fixtures/client_app_with_antd/app.jac,sha256=j2N82axLh4lKXjsAceETK0_W3kUGVMQzeFaCKYCHLQ4,490
+jac_client/tests/fixtures/js_import/app.jac,sha256=O_cXpjgmVXNDlPywhE6JCnWpMXguuaGhrVlf32vrgpc,720
+jac_client/tests/fixtures/js_import/utils.js,sha256=lrcZ9yUEb4QrpUpUp0gWRvISFui9_v96rWPN-btllmU,413
+jac_client/tests/fixtures/package-lock.json,sha256=RKNoyMoGXx3IOm3B5d1Kt0vrgMac9intCLXGew51AAQ,19358
+jac_client/tests/fixtures/package.json,sha256=s5Ltvbh1MQGeZZyyNJdqhoA21VO5F7scBcVPlgHpF3c,278
+jac_client/tests/fixtures/relative_import/app.jac,sha256=F0BD1eDVATHNGOXkip6saOlsIrI-Ageh0ctw5Ky2Yq8,189
+jac_client/tests/fixtures/relative_import/button.jac,sha256=8xLhhX7UpiRdzO9BLC1XwhejiKMEi50VlPFSjJP0XR8,109
+jac_client/tests/fixtures/spawn_test/app.jac,sha256=2SA2kQ6vyQxNxRvTSJb6dEZDavK-YYQ2qI3Ot63_xJ4,4045
+jac_client/tests/fixtures/test_fragments_spread/app.jac,sha256=zdEpVXGB_C3EmWS0TIR4EIHF4Dw_Iu4AfhBP1DDrurs,1114
+jac_client/tests/test_cl.py,sha256=lR16col1HCcaJzqGlGzWVd_aF0zNMfLOfgxylvSzGZE,20109
+jac_client/tests/test_create_jac_app.py,sha256=ahVpMR_7Cil988-Ji8vbpNmEUWBxtBNn0hiOtqkniQU,5514
+jac_client-0.2.0.dist-info/METADATA,sha256=hPCucmge43Kd8ttKwyAgOMGEofgOp4ecFyOQwG5cAsc,4485
+jac_client-0.2.0.dist-info/WHEEL,sha256=zp0Cn7JsFoX2ATtOhtaFYIiE2rmFAD4OcMhtUki8W3U,88
+jac_client-0.2.0.dist-info/entry_points.txt,sha256=WxzPDwDUGAvQyJ_RkIOSk3cJgJChESQGP839Kb70_vo,92
+jac_client-0.2.0.dist-info/RECORD,,

jac_client-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.2.1
+Root-Is-Purelib: true
+Tag: py3-none-any

jac_client-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,4 @@
+[jac]
+create_jac_app=jac_client.plugin.cli:JacCmd
+serve=jac_client.plugin.client:JacClient
+