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

jac_client/examples/asset-serving/css-with-image/vite.config.js

@@ -1,28 +0,0 @@
-
-import { defineConfig } from "vite";
-import path from "path";
-import { fileURLToPath } from "url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-export default defineConfig({
-  root: ".", // base folder
-  build: {
-    rollupOptions: {
-      input: "build/main.js", // your compiled entry file
-      output: {
-        entryFileNames: "client.[hash].js", // name of the final js file
-        assetFileNames: "[name].[ext]",
-      },
-    },
-    outDir: "dist", // final bundled output
-    emptyOutDir: true,
-  },
-  publicDir: false,
-  resolve: {
-    alias: {
-      "@jac-client/utils": path.resolve(__dirname, "src/client_runtime.js"),
-      "@jac-client/assets": path.resolve(__dirname, "src/assets"),
-    },
-  },
-});

jac_client/examples/asset-serving/image-asset/.babelrc

@@ -1,9 +0,0 @@
-
-{
-    "presets": [[
-        "@babel/preset-env",
-        {
-            "modules": false
-        }
-    ], "@babel/preset-react"]
-}

jac_client/examples/asset-serving/image-asset/README.md

@@ -1,119 +0,0 @@
-# Static Path Example
-
-This example demonstrates how to serve static assets using direct `/static/` path references.
-
-## Features
-
-- Direct path references using `/static/assets/` URLs
-- Simple and straightforward approach
-- No build configuration required
-- Works immediately without imports
-
-## Project Structure
-
-```
-image-asset/
-├── app.jac          # Main application file
-├── assets/          # Static assets directory
-│   └── burger.png   # Burger image
-├── src/             # Source files (generated)
-├── build/           # Build output (generated)
-└── dist/            # Distribution output (generated)
-```
-
-## Running the Example
-
-1. Make sure node modules are installed:
-```bash
-npm install
-```
-
-2. Run the Jac server:
-```bash
-jac serve app.jac
-```
-
-3. Open your browser and navigate to:
-```
-http://localhost:8000/page/app
-```
-
-## How It Works
-
-### Static Path Syntax
-
-```jac
-<img src="/static/assets/burger.png" alt="Burger" />
-```
-
-### Server Configuration
-
-The server automatically serves files from:
-- `dist/` directory (Vite-bundled assets)
-- `assets/` directory (user-provided static assets)
-
-Both directories are checked when serving `/static/*` requests.
-
-### Path Resolution
-
-1. Request: `/static/assets/burger.png`
-2. Server checks `dist/assets/burger.png` first
-3. If not found, checks `assets/burger.png`
-4. Serves file with appropriate MIME type
-5. Sets cache headers for optimal performance
-
-### Benefits
-
-- **Simplicity**: No imports or build configuration needed
-- **Immediate**: Works right away without build step
-- **Flexible**: Easy to reference assets from anywhere
-- **Quick Prototyping**: Perfect for rapid development
-
-### Use Cases
-
-**Direct Image References:**
-```jac
-<img src="/static/assets/logo.png" alt="Logo" />
-```
-
-**CSS Background Images:**
-```jac
-<div style={{backgroundImage: "url('/static/assets/hero.jpg')"}} />
-```
-
-**Dynamic Asset Paths:**
-```jac
-let imagePath = `/static/assets/${imageName}.png`;
-<img src={imagePath} />
-```
-
-## Best Practices
-
-1. Use this method for quick prototypes
-2. Organize assets in the `assets/` folder
-3. Use descriptive file names
-4. Keep assets reasonably sized
-5. Consider using imports for production apps
-
-## Limitations
-
-- No automatic optimization
-- No hash-based cache busting
-- Manual cache control required
-- No type safety for asset paths
-
-## When to Use
-
-**Choose Static Path if:**
-- Building a quick prototype
-- Assets don't need optimization
-- Want immediate results
-- Working with simple, small assets
-
-**Consider Import Methods if:**
-- Building for production
-- Need automatic optimization
-- Want cache busting
-- Prefer type-safe references
-
-Happy coding with Jac! 🍔

jac_client/examples/asset-serving/image-asset/package.json

@@ -1,28 +0,0 @@
-{
-  "name": "image-asset",
-  "version": "1.0.0",
-  "main": "index.js",
-  "scripts": {
-    "build": "npm run compile && vite build",
-    "dev": "vite dev",
-    "preview": "vite preview",
-    "compile": "babel src --out-dir build --extensions \".jsx,.js\" --out-file-extension .js"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "description": "Jac application: image-asset",
-  "type": "module",
-  "devDependencies": {
-    "vite": "^6.4.1",
-    "@babel/cli": "^7.28.3",
-    "@babel/core": "^7.28.5",
-    "@babel/preset-env": "^7.28.5",
-    "@babel/preset-react": "^7.28.5"
-  },
-  "dependencies": {
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
-    "react-router-dom": "^6.30.1"
-  }
-}

jac_client/examples/asset-serving/image-asset/styles.css

@@ -1,26 +0,0 @@
-.container {
-    background-image: url('/static/assets/burger.png');
-    background-size: cover;
-    background-position: center;
-    min-height: 300px;
-    border-radius: 10px;
-    padding: 20px;
-    margin: 20px 0;
-}
-
-.card {
-    background: white;
-    border-radius: 10px;
-    padding: 20px;
-    box-shadow: 0 4px 8px rgba(0,0,0,0.2);
-    max-width: 400px;
-    margin: 20px auto;
-}
-
-.burgerImage {
-    width: 200px;
-    height: auto;
-    border-radius: 10px;
-    display: block;
-    margin: 0 auto;
-}

jac_client/examples/asset-serving/image-asset/vite.config.js

@@ -1,28 +0,0 @@
-
-import { defineConfig } from "vite";
-import path from "path";
-import { fileURLToPath } from "url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-export default defineConfig({
-  root: ".", // base folder
-  build: {
-    rollupOptions: {
-      input: "build/main.js", // your compiled entry file
-      output: {
-        entryFileNames: "client.[hash].js", // name of the final js file
-        assetFileNames: "[name].[ext]",
-      },
-    },
-    outDir: "dist", // final bundled output
-    emptyOutDir: true,
-  },
-  publicDir: false,
-  resolve: {
-    alias: {
-      "@jac-client/utils": path.resolve(__dirname, "src/client_runtime.js"),
-      "@jac-client/assets": path.resolve(__dirname, "src/assets"),
-    },
-  },
-});

jac_client/examples/asset-serving/import-alias/.babelrc

@@ -1,9 +0,0 @@
-
-{
-    "presets": [[
-        "@babel/preset-env",
-        {
-            "modules": false
-        }
-    ], "@babel/preset-react"]
-}

jac_client/examples/asset-serving/import-alias/README.md

@@ -1,83 +0,0 @@
-# Import Alias Example
-
-This example demonstrates how to import static assets using the `@jac-client/assets` alias pattern.
-
-## Features
-
-- Imports image using `@jac-client/assets` alias
-- Vite processes and optimizes the asset
-- Automatic hash generation for cache busting
-- Type-safe asset references
-
-## Project Structure
-
-```
-import-alias/
-├── app.jac          # Main application file
-├── assets/          # Static assets directory
-│   └── burger.png   # Burger image
-├── src/             # Source files (generated)
-├── build/           # Build output (generated)
-└── dist/            # Distribution output (generated)
-```
-
-## Running the Example
-
-1. Make sure node modules are installed:
-```bash
-npm install
-```
-
-2. Run the Jac server:
-```bash
-jac serve app.jac
-```
-
-3. Open your browser and navigate to:
-```
-http://localhost:8000/page/app
-```
-
-## How It Works
-
-### Import Syntax
-
-```jac
-cl import from "@jac-client/assets/burger.png" { default as burgerImage }
-<img src={burgerImage} />
-```
-
-### Configuration
-
-The alias is configured in `vite.config.js`:
-
-```javascript
-resolve: {
-  alias: {
-    "@jac-client/assets": path.resolve(__dirname, "src/assets"),
-  },
-}
-```
-
-### Build Process
-
-1. Assets from root `assets/` folder are copied to `src/assets/` during build
-2. Vite processes the import and generates optimized asset URLs
-3. Assets are bundled with hash-based filenames for cache invalidation
-4. The imported variable contains the processed asset URL
-
-### Benefits
-
-- **Type Safety**: Import errors caught at build time
-- **Optimization**: Vite automatically optimizes assets
-- **Cache Busting**: Hash-based filenames prevent stale cache
-- **Code Splitting**: Assets can be code-split automatically
-
-## Best Practices
-
-1. Use this method for production applications
-2. Organize assets in the `assets/` folder
-3. Let Vite handle optimization and caching
-4. Use descriptive variable names for imported assets
-
-Happy coding with Jac! 🍔

jac_client/examples/asset-serving/import-alias/package.json

@@ -1,28 +0,0 @@
-{
-  "name": "import-alias",
-  "version": "1.0.0",
-  "main": "index.js",
-  "scripts": {
-    "build": "npm run compile && vite build",
-    "dev": "vite dev",
-    "preview": "vite preview",
-    "compile": "babel src --out-dir build --extensions \".jsx,.js\" --out-file-extension .js"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "description": "Jac application: import-alias",
-  "type": "module",
-  "devDependencies": {
-    "vite": "^6.4.1",
-    "@babel/cli": "^7.28.3",
-    "@babel/core": "^7.28.5",
-    "@babel/preset-env": "^7.28.5",
-    "@babel/preset-react": "^7.28.5"
-  },
-  "dependencies": {
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
-    "react-router-dom": "^6.30.1"
-  }
-}

jac_client/examples/asset-serving/import-alias/vite.config.js

@@ -1,28 +0,0 @@
-
-import { defineConfig } from "vite";
-import path from "path";
-import { fileURLToPath } from "url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-export default defineConfig({
-  root: ".", // base folder
-  build: {
-    rollupOptions: {
-      input: "build/main.js", // your compiled entry file
-      output: {
-        entryFileNames: "client.[hash].js", // name of the final js file
-        assetFileNames: "[name].[ext]",
-      },
-    },
-    outDir: "dist", // final bundled output
-    emptyOutDir: true,
-  },
-  publicDir: false,
-  resolve: {
-    alias: {
-      "@jac-client/utils": path.resolve(__dirname, "src/client_runtime.js"),
-      "@jac-client/assets": path.resolve(__dirname, "src/assets"),
-    },
-  },
-});

jac_client/examples/basic/.babelrc

@@ -1,9 +0,0 @@
-
-{
-    "presets": [[
-        "@babel/preset-env",
-        {
-            "modules": false
-        }
-    ], "@babel/preset-react"]
-}

jac_client/examples/basic/README.md

@@ -1,16 +0,0 @@
-# my-app
-make sure node modules are installed:
-```bash
-npm install
-```
-
-
-## Running Jac Code
-
-To run your Jac code, use the Jac CLI:
-
-```bash
-jac serve app.jac
-```
-
-Happy coding with Jac!

jac_client/examples/basic/package.json

@@ -1,27 +0,0 @@
-{
-  "name": "my-app",
-  "version": "1.0.0",
-  "main": "index.js",
-  "scripts": {
-    "build": "npm run compile && vite build",
-    "dev": "vite dev",
-    "preview": "vite preview",
-    "compile": "babel src --out-dir build --extensions \".jsx,.js\" --out-file-extension .js"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "description": "Jac application: my-app",
-  "type": "module",
-  "devDependencies": {
-    "vite": "^6.4.1",
-    "@babel/cli": "^7.28.3",
-    "@babel/core": "^7.28.5",
-    "@babel/preset-env": "^7.28.5",
-    "@babel/preset-react": "^7.28.5"
-  },
-  "dependencies": {
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0"
-  }
-}

jac_client/examples/basic/vite.config.js

@@ -1,27 +0,0 @@
-
-import { defineConfig } from "vite";
-import path from "path";
-import { fileURLToPath } from "url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-export default defineConfig({
-  root: ".", // base folder
-  build: {
-    rollupOptions: {
-      input: "build/main.js", // your compiled entry file
-      output: {
-        entryFileNames: "client.[hash].js", // name of the final js file
-        assetFileNames: "[name].[ext]",
-      },
-    },
-    outDir: "dist", // final bundled output
-    emptyOutDir: true,
-  },
-  publicDir: false,
-  resolve: {
-    alias: {
-      "@jac-client/utils": path.resolve(__dirname, "src/client_runtime.js"),
-    },
-  },
-});

jac_client/examples/basic-auth/.babelrc

@@ -1,9 +0,0 @@
-
-{
-    "presets": [[
-        "@babel/preset-env",
-        {
-            "modules": false
-        }
-    ], "@babel/preset-react"]
-}

jac_client/examples/basic-auth/README.md

@@ -1,16 +0,0 @@
-# basic-auth
-
-## Running Jac Code
-
-make sure node modules are installed:
-```bash
-npm install
-```
-
-To run your Jac code, use the Jac CLI:
-
-```bash
-jac serve app.jac
-```
-
-Happy coding with Jac!