Merge pull request #3240 from jaseci-labs/3209-bug-fix-stripping-3rd-party-library-imports

3209 bug fix stripping 3rd party library imports

Author: marsninja

.github/workflows/release-client.yml

@@ -0,0 +1,31 @@
+name: Release jac-client to PYPI
+
+on: workflow_dispatch
+
+jobs:
+  release-client:
+    name: Release
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: jac-client
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+      - name: Set up Python
+        uses: actions/setup-python@v2
+        with:
+          python-version: '3.12'
+      - name: Install Poetry
+        run: |
+          pip install poetry
+      - name: Build and publish package
+        run: |
+          poetry config pypi-token.pypi ${{ secrets.PYPI_TOKEN }}
+          poetry build
+          poetry publish
+      # - run: pip install githubrelease
+      # - run: python scripts/gh_release.py
+      #   env:
+      #     GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}

.github/workflows/test-jaseci.yml

@@ -58,6 +58,10 @@ jobs:
         DATABASE_HOST: mongodb://localhost/?retryWrites=true&w=majority
         REDIS_HOST: redis://localhost
         TASK_CONSUMER_CRON_SECOND: "*"
+    - name: Run Jac-Client tests
+      run: |
+        pip install -e jac-client
+        pytest -x jac-client
     - name: Run littleX tests
       run: |
         pip install numpy

docs/docs/communityhub/release_notes/jac-client.md

@@ -2,14 +2,18 @@
 
 This document provides a summary of new features, improvements, and bug fixes in each version of **Jac-Client**. For details on changes that might require updates to your existing code, please refer to the [Breaking Changes](../breaking_changes.md) page.
 
-## jaclang 0.9.0 / jac-cloud 0.2.11 / byllm 0.4.6 / jac-client 0.1.0 (Unreleased)
+## jaclang 0.9.0 / jac-client 0.1.0 (Unreleased)
 
 - **Client Bundler Plugin Support**: Extended the existing `pluggy`-based plugin architecture to support custom client bundling implementations. Two static methods were added to `JacMachineInterface` to enable client bundler plugins:
   - `get_client_bundle_builder()`: Returns the client bundle builder instance, allowing plugins to provide custom bundler implementations
   - `build_client_bundle()`: Builds client bundles for modules, can be overridden by plugins to use custom bundling strategies
 
 - **ViteBundlerPlugin (jac-client)**: Official Vite-based bundler plugin providing production-ready JavaScript bundling with HMR, tree shaking, code splitting, TypeScript support, and asset optimization. Implements the `build_client_bundle()` hook to replace default bundling with Vite's optimized build system. Install `jac-client` library from the source and use it for automatic Vite-powered client bundle generation.
 
+- **Import System Fix**: Fixed relative imports in client bundles, added support for third-party npm modules, and implemented validation for pure JavaScript file imports.
+
+- **PYPI Package Release**: First stable release (v0.1.0) now available on PyPI. Install via `pip install jac-client` to get started with Vite-powered client bundling for your Jac projects.
+
 ## jaclang 0.8.10 / jac-cloud 0.2.10 / byllm 0.4.5 (Latest Release)
 
 ## jaclang 0.8.9 / jac-cloud 0.2.9 / byllm 0.4.4

jac-client/README.md

@@ -1,60 +1,111 @@
-Jac Client
-==========
+# Jac Client
 
-Lightweight plugin that adds Vite-powered client bundling to Jac programs. It provides a `ClientBundleBuilder` implementation discovered by the Jac runtime via entry-points, so you can generate optimized browser bundles from Jac client code automatically.
+Build full-stack web applications with Jac - one language for frontend and backend.
 
-Requirements
-------------
-- Python: 3.12+
-- Python deps: `jaclang==0.8.10` (installed transitively)
-- Node.js tooling available on PATH:
-  - `node`/`npm` (or `pnpm`/`yarn` if `npx` can execute Vite)
-  - `npx` and Vite present in your frontend project (`devDependencies`)
+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
+- **Reactive State**: Built-in state management with `createState()`
+- **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
 
-Install
--------
-Using pip:
+### Installation
 
 ```bash
 pip install jac-client
 ```
 
-Using Poetry inside a project:
+### Create a New App
 
 ```bash
-poetry add jac-client
+jac create_jac_app my-app
+cd my-app
+jac serve app.jac
 ```
 
+Visit `http://localhost:8000` 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 `initRouter()`
+- **[Lifecycle Hooks](jac_client/docs/lifecycle-hooks.md)** - Using `onMount()` for initialization
+- **[Advanced State](jac_client/docs/advanced-state.md)** - Managing complex state
+- **[Imports](jac_client/docs/imports.md)** - Importing libraries, Jac files, and JavaScript modules
+
+---
+
+## 💡 Example
+
+```jac
+cl {
+    let [count, setCount] = createState({"value": 0});
+
+    def Counter() -> any {
+        s = count();
+        return <div>
+            <h1>Count: {s.value}</h1>
+            <button onClick={lambda -> None {
+                setCount({"value": s.value + 1});
+            }}>
+                Increment
+            </button>
+        </div>;
+    }
+
+    def jac_app() -> any {
+        return Counter();
+    }
+}
 ```
-your_app/
-  package.json           # contains vite in devDependencies
-  node_modules/
-  static/
-    client/
-      js/                # Vite output will be written here
-  your_program.jac       # your Jac source
-```
 
-How it works
-------------
-At runtime, Jac discovers the `JacClient` plugin and calls its builder:
+---
+
+## 🔧 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
 
-- `jac_client.plugin.client.JacClient.get_client_bundle_builder()` returns `ViteClientBundleBuilder` configured with paths resolved from `JacMachine.base_path_dir`.
-- The builder compiles `.jac` client code to JS, stitches any client imports, injects an init script that registers exports with the Jac runtime, then runs Vite to produce an optimized IIFE bundle named `client.[hash].js`.
+- **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)
 
-Troubleshooting
----------------
-- npx/vite not found: ensure Node.js is installed and that `package.json` has Vite in `devDependencies` (so `npx vite` works in your app root).
-- Build completes but no bundle found: the builder expects Vite to emit `client.[hash].js`; check custom Vite configs or permissions in the output directory.
-- Output directory missing: the plugin will create the directory if needed, but verify the process has write permissions to `<base_path_dir>/static/client/js`.
+---
 
-Contributing
-------------
-- See `jac-client/TODO.md` for improvements and `jac-client/ROADMAP.md` for direction.
-- PRs to enhance cross-platform path handling, dev HMR, and caching are welcome.
+## 📄 License
 
-License
--------
-MIT (see repository root `LICENSE`).
+MIT License - see [LICENSE](../LICENSE) file.
 
+---
 
+**Happy coding with Jac!** 🎉

jac-client/TODO.md

@@ -55,3 +55,6 @@
 - ✅ Completed
 - ⏸️ On Hold
 
+
+
+utility library code