creation-framework 0.1.0a2__tar.gz

creation_framework-0.1.0a2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Parag Ghatage
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

creation_framework-0.1.0a2/PKG-INFO

@@ -0,0 +1,254 @@
+Metadata-Version: 2.4
+Name: creation-framework
+Version: 0.1.0a2
+Summary: A Python-first UI framework that runs in the browser using Pyodide. This is a fork of Evolve by Parag Ghatage.
+Author-email: Alexander Matulionis <a.matulionis@usa.com>
+License: MIT
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+
+<div align="center">
+  <h1>🌍 Creation</h1>
+  <p><strong>The Python-Native Frontend Framework</strong></p>
+  <p>
+    <a href="https://pypi.org/project/creation/">
+      <img src="https://img.shields.io/badge/pypi-v0.1.0-blue?style=flat-square&logo=pypi&logoColor=white" alt="PyPI Version" />
+    </a>
+    <a href="#">
+      <img src="https://img.shields.io/badge/python-3.11+-yellow?style=flat-square&logo=python&logoColor=white" alt="Python Version" />
+    </a>
+    <a href="LICENSE">
+      <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="License" />
+    </a>
+  </p>
+
+  <p>
+    Build high-performance, reactive web applications entirely in Python.<br/>
+    Powered by <strong>Pyodide (WASM)</strong> and a fine-grained <strong>Solid.js-style</strong> reactive engine.
+  </p>
+</div>
+
+---
+### Highlights
+
+- **⚡ Zero Virtual DOM:** Uses fine-grained signals for direct DOM updates (O(1) complexity).
+- **🐍 Python Native:** Write components, routing, and logic in pure Python.
+- **📦 Tiny Bundle:** A minimal JS kernel coupled with an optimized Python environment.
+- **🌐 Static Deployment:** Builds to pure HTML/CSS/WASM. Deploy to Vercel, Netlify, or GitHub Pages.
+---
+
+
+
+**Creation** is a paradigm shift for Python web development. Unlike traditional frameworks that render HTML on the server (Django, Flask) or wrap heavy JS runtimes, Creation runs **natively in the browser** via WebAssembly.
+
+It features a **radical 2KB JavaScript micro-kernel** that handles DOM operations, while your application logic, state management, and component rendering happen entirely in Python.
+
+This is a fork of Evolve by Parag Ghatage.
+
+##  Installation
+
+Requires Python 3.11+.
+
+```bash
+pip install creation
+````
+
+-----
+
+##  Quick Start
+
+Get a reactive app running in seconds.
+
+### 1\. Initialize a Project
+
+```bash
+creation init my-app
+cd my-app
+```
+
+This creates a simple `app.py` with example routes.
+
+### 2\. Run the Dev Server
+
+```bash
+creation run
+```
+
+Visit `http://localhost:3000` to see your app.
+
+### 3\. Build for Production
+
+```bash
+creation build
+```
+
+This compiles your app into `.creation/dist/`, ready for static hosting.
+
+-----
+
+##  The "Hello World" Component
+
+Creation uses a FastAPI-style decorator syntax. Create an `app.py` anywhere:
+
+```python
+from creation.router.router import page
+from creation.src.html import div, h1, button, p
+from creation.reactive.reactive import signal
+
+@page("/")
+def Home():
+    # Reactive state (Signals)
+    count = signal(0)
+
+    def increment(ev=None):
+        count(count() + 1)
+
+    return div(
+        h1("Welcome to Creation 🌍"),
+        p(lambda: f"Count: {count()}"),  # Reactive text
+        button("Increment", on_click=increment),
+        style={"textAlign": "center", "fontFamily": "sans-serif"}
+    )
+```
+
+Run it:
+```bash
+creation run app.py
+```
+
+-----
+
+##  Key Features
+
+### 1\. Fine-Grained Reactivity (Signals)
+
+Creation doesn't re-render entire components. When a `signal` changes, only the specific text node or attribute bound to it updates.
+
+```python
+from creation.reactive.reactive import signal, computed
+
+count = signal(0)
+double = computed(lambda: count() * 2)
+
+# Use lambda for reactive text that updates automatically
+span(lambda: f"Double is: {double()}") 
+```
+
+### 2\. Built-in Routing
+
+A lightweight, history-mode router is included out of the box.
+
+```python
+from creation.router.router import page, Link
+
+@page("/about")
+def About():
+    return div(
+        h1("About Us"),
+        Link("Go Home", to="/")
+    )
+```
+
+### 3\. Tailwind-Style Styling
+
+Creation includes a `tw()` utility for rapid styling without leaving Python.
+
+```python
+from creation.src.html import div, tw
+
+div("Hello", **tw("text-white bg-blue-500 p-4 rounded-lg flex justify-center"))
+```
+
+### 4\. Component Lifecycle
+
+Hook into mount and unmount events for side effects (API calls, subscriptions).
+
+```python
+from creation.components.component import component
+from creation.core.lifecycle import on_mount, on_cleanup
+
+@component
+def Timer():
+    on_mount(lambda: print("Component mounted!"))
+    on_cleanup(lambda: print("Cleaned up!"))
+    return div("Timer Component")
+```
+
+-----
+
+##  Architecture
+
+Creation bridges the gap between Python and the Browser DOM using a highly efficient architecture:
+
+```mermaid
+flowchart TD
+    subgraph Browser ["Browser (WASM Context)"]
+        direction TB
+        App[Your App.py] --> Reactive[Reactive Engine]
+        Reactive --> Diff[Diff Engine]
+        Diff --> Patch[Patch List]
+    end
+
+    subgraph Kernel ["JS Micro-Kernel"]
+        Bridge[Pyodide Bridge]
+        RealDOM[Real DOM]
+    end
+
+    Patch -- "Serialized Ops" --> Bridge
+    Bridge --> RealDOM
+    RealDOM -- "Events" --> App
+
+```
+
+1.  **Python Layer:** Calculates changes using Signals.
+2.  **Diff Engine:** Generates a minimal list of DOM operations (patches).
+3.  **JS Kernel:** A tiny JavaScript layer receives patches and applies them to the real DOM.
+
+-----
+
+##  Project Structure
+
+When you run `creation init`, the following structure is created:
+
+```text
+my-app/
+├── components/       # Reusable UI components
+├── pages/            # Route handlers (@page)
+├── public/           # Static assets (images, fonts)
+├── creation.zip      # Packed engine (generated on build)
+└── app.py            # Entry point (auto-generated)
+```
+
+-----
+
+##  Roadmap
+
+  - [x] **v0.1:** Core Reactive Engine & JS Kernel
+  - [x] **v0.1:** Component System & Routing
+  - [x] **v0.1:** CLI (`init`, `build`, `run`)
+  - [ ] **v0.2:** Global State Management (Store)
+  - [ ] **v0.3:** Form Handling & Validation
+  - [ ] **v0.4:** Server-Side Rendering (SSR) capabilities
+  - [ ] **v1.0:** Full WASM Component Model Support
+
+-----
+
+##  Contributing
+
+We welcome contributions\! Please see our [Contributing Guide](#) for details on how to set up the development environment.
+
+1.  Fork the Project
+2.  Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
+3.  Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
+4.  Push to the Branch (`git push origin feature/AmazingFeature`)
+5.  Open a Pull Request
+
+-----
+
+##  License
+
+Distributed under the MIT License. See `LICENSE` for more information.
+-----

creation_framework-0.1.0a2/README.md

@@ -0,0 +1,243 @@
+
+<div align="center">
+  <h1>🌍 Creation</h1>
+  <p><strong>The Python-Native Frontend Framework</strong></p>
+  <p>
+    <a href="https://pypi.org/project/creation/">
+      <img src="https://img.shields.io/badge/pypi-v0.1.0-blue?style=flat-square&logo=pypi&logoColor=white" alt="PyPI Version" />
+    </a>
+    <a href="#">
+      <img src="https://img.shields.io/badge/python-3.11+-yellow?style=flat-square&logo=python&logoColor=white" alt="Python Version" />
+    </a>
+    <a href="LICENSE">
+      <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="License" />
+    </a>
+  </p>
+
+  <p>
+    Build high-performance, reactive web applications entirely in Python.<br/>
+    Powered by <strong>Pyodide (WASM)</strong> and a fine-grained <strong>Solid.js-style</strong> reactive engine.
+  </p>
+</div>
+
+---
+### Highlights
+
+- **⚡ Zero Virtual DOM:** Uses fine-grained signals for direct DOM updates (O(1) complexity).
+- **🐍 Python Native:** Write components, routing, and logic in pure Python.
+- **📦 Tiny Bundle:** A minimal JS kernel coupled with an optimized Python environment.
+- **🌐 Static Deployment:** Builds to pure HTML/CSS/WASM. Deploy to Vercel, Netlify, or GitHub Pages.
+---
+
+
+
+**Creation** is a paradigm shift for Python web development. Unlike traditional frameworks that render HTML on the server (Django, Flask) or wrap heavy JS runtimes, Creation runs **natively in the browser** via WebAssembly.
+
+It features a **radical 2KB JavaScript micro-kernel** that handles DOM operations, while your application logic, state management, and component rendering happen entirely in Python.
+
+This is a fork of Evolve by Parag Ghatage.
+
+##  Installation
+
+Requires Python 3.11+.
+
+```bash
+pip install creation
+````
+
+-----
+
+##  Quick Start
+
+Get a reactive app running in seconds.
+
+### 1\. Initialize a Project
+
+```bash
+creation init my-app
+cd my-app
+```
+
+This creates a simple `app.py` with example routes.
+
+### 2\. Run the Dev Server
+
+```bash
+creation run
+```
+
+Visit `http://localhost:3000` to see your app.
+
+### 3\. Build for Production
+
+```bash
+creation build
+```
+
+This compiles your app into `.creation/dist/`, ready for static hosting.
+
+-----
+
+##  The "Hello World" Component
+
+Creation uses a FastAPI-style decorator syntax. Create an `app.py` anywhere:
+
+```python
+from creation.router.router import page
+from creation.src.html import div, h1, button, p
+from creation.reactive.reactive import signal
+
+@page("/")
+def Home():
+    # Reactive state (Signals)
+    count = signal(0)
+
+    def increment(ev=None):
+        count(count() + 1)
+
+    return div(
+        h1("Welcome to Creation 🌍"),
+        p(lambda: f"Count: {count()}"),  # Reactive text
+        button("Increment", on_click=increment),
+        style={"textAlign": "center", "fontFamily": "sans-serif"}
+    )
+```
+
+Run it:
+```bash
+creation run app.py
+```
+
+-----
+
+##  Key Features
+
+### 1\. Fine-Grained Reactivity (Signals)
+
+Creation doesn't re-render entire components. When a `signal` changes, only the specific text node or attribute bound to it updates.
+
+```python
+from creation.reactive.reactive import signal, computed
+
+count = signal(0)
+double = computed(lambda: count() * 2)
+
+# Use lambda for reactive text that updates automatically
+span(lambda: f"Double is: {double()}") 
+```
+
+### 2\. Built-in Routing
+
+A lightweight, history-mode router is included out of the box.
+
+```python
+from creation.router.router import page, Link
+
+@page("/about")
+def About():
+    return div(
+        h1("About Us"),
+        Link("Go Home", to="/")
+    )
+```
+
+### 3\. Tailwind-Style Styling
+
+Creation includes a `tw()` utility for rapid styling without leaving Python.
+
+```python
+from creation.src.html import div, tw
+
+div("Hello", **tw("text-white bg-blue-500 p-4 rounded-lg flex justify-center"))
+```
+
+### 4\. Component Lifecycle
+
+Hook into mount and unmount events for side effects (API calls, subscriptions).
+
+```python
+from creation.components.component import component
+from creation.core.lifecycle import on_mount, on_cleanup
+
+@component
+def Timer():
+    on_mount(lambda: print("Component mounted!"))
+    on_cleanup(lambda: print("Cleaned up!"))
+    return div("Timer Component")
+```
+
+-----
+
+##  Architecture
+
+Creation bridges the gap between Python and the Browser DOM using a highly efficient architecture:
+
+```mermaid
+flowchart TD
+    subgraph Browser ["Browser (WASM Context)"]
+        direction TB
+        App[Your App.py] --> Reactive[Reactive Engine]
+        Reactive --> Diff[Diff Engine]
+        Diff --> Patch[Patch List]
+    end
+
+    subgraph Kernel ["JS Micro-Kernel"]
+        Bridge[Pyodide Bridge]
+        RealDOM[Real DOM]
+    end
+
+    Patch -- "Serialized Ops" --> Bridge
+    Bridge --> RealDOM
+    RealDOM -- "Events" --> App
+
+```
+
+1.  **Python Layer:** Calculates changes using Signals.
+2.  **Diff Engine:** Generates a minimal list of DOM operations (patches).
+3.  **JS Kernel:** A tiny JavaScript layer receives patches and applies them to the real DOM.
+
+-----
+
+##  Project Structure
+
+When you run `creation init`, the following structure is created:
+
+```text
+my-app/
+├── components/       # Reusable UI components
+├── pages/            # Route handlers (@page)
+├── public/           # Static assets (images, fonts)
+├── creation.zip      # Packed engine (generated on build)
+└── app.py            # Entry point (auto-generated)
+```
+
+-----
+
+##  Roadmap
+
+  - [x] **v0.1:** Core Reactive Engine & JS Kernel
+  - [x] **v0.1:** Component System & Routing
+  - [x] **v0.1:** CLI (`init`, `build`, `run`)
+  - [ ] **v0.2:** Global State Management (Store)
+  - [ ] **v0.3:** Form Handling & Validation
+  - [ ] **v0.4:** Server-Side Rendering (SSR) capabilities
+  - [ ] **v1.0:** Full WASM Component Model Support
+
+-----
+
+##  Contributing
+
+We welcome contributions\! Please see our [Contributing Guide](#) for details on how to set up the development environment.
+
+1.  Fork the Project
+2.  Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
+3.  Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
+4.  Push to the Branch (`git push origin feature/AmazingFeature`)
+5.  Open a Pull Request
+
+-----
+
+##  License
+
+Distributed under the MIT License. See `LICENSE` for more information.
+-----

creation_framework-0.1.0a2/creation/__init__.py

@@ -0,0 +1,97 @@
+"""
+Creation - A Python web framework powered by Pyodide.
+
+Core APIs:
+    - signal, computed, effect, batch - Reactive primitives
+    - component, @page, Link - Component and routing
+    - div, span, button, etc. - HTML elements with tw() styling
+    - set_timeout, set_interval - Browser timers
+    - create_store - Global state management
+    - use_effect, use_memo, use_ref - React-like hooks
+
+Note: Browser-only modules (kernel, dom, timers) are only imported at runtime
+in Pyodide, not at CLI time.
+"""
+
+__version__ = "0.1.0"
+
+# Public API exports for IDE autocompletion and discoverability
+__all__ = [
+    # Version
+    "__version__",
+    # Reactive primitives
+    "signal", "computed", "effect", "batch", "Signal", "Computed",
+    # Components
+    "component",
+    # Routing
+    "page", "Link", "navigate",
+    # Timers
+    "set_timeout", "set_interval", "clear_timeout", "clear_interval",
+    # Hooks
+    "use_effect", "use_memo", "use_ref", "use_callback",
+    # Lifecycle
+    "on_mount", "on_cleanup",
+    # HTML elements
+    "tw", "div", "span", "p", "button", "input", "a", 
+    "h1", "h2", "h3", "h4", "h5", "h6",
+    # Store
+    "create_store", "init_store", "get_store",
+    # Context
+    "create_context", "use_context",
+    # Error handling
+    "ErrorBoundary",
+]
+
+
+def __getattr__(name):
+    """
+    Lazy import to avoid loading browser-only modules at CLI time.
+    This allows the CLI to work while still providing convenient imports
+    when running in Pyodide.
+    """
+    # Reactive (safe to import)
+    if name in ("signal", "computed", "effect", "batch", "Signal", "Computed"):
+        from .reactive.reactive import signal, computed, effect, batch, Signal, Computed
+        return locals()[name]
+    
+    # Store (safe to import)
+    if name in ("create_store", "init_store", "get_store"):
+        from .store.store import create_store, init_store, get_store
+        return locals()[name]
+    
+    # The following require browser environment (js module)
+    # They will fail at CLI time but work in Pyodide
+    
+    if name == "component":
+        from .components.component import component
+        return component
+    
+    if name in ("page", "Link", "navigate"):
+        from .router.router import page, Link, navigate
+        return locals()[name]
+    
+    if name in ("set_timeout", "set_interval", "clear_timeout", "clear_interval"):
+        from .kernel.timers import set_timeout, set_interval, clear_timeout, clear_interval
+        return locals()[name]
+    
+    if name in ("use_effect", "use_memo", "use_ref", "use_callback"):
+        from .hooks.hooks import use_effect, use_memo, use_ref, use_callback
+        return locals()[name]
+    
+    if name in ("tw", "div", "span", "p", "button", "input", "a", "h1", "h2", "h3", "h4", "h5", "h6"):
+        from .src.html import tw, div, span, p, button, input, a, h1, h2, h3, h4, h5, h6
+        return locals()[name]
+    
+    if name == "ErrorBoundary":
+        from .error.error import ErrorBoundary
+        return ErrorBoundary
+    
+    if name in ("create_context", "use_context"):
+        from .context.context import create_context, use_context
+        return locals()[name]
+    
+    if name in ("on_mount", "on_cleanup"):
+        from .core.lifecycle import on_mount, on_cleanup
+        return locals()[name]
+    
+    raise AttributeError(f"module 'creation' has no attribute '{name}'")