create-gardener 1.1.6 → 1.1.8

package/.envrc

@@ -1 +0,0 @@
-use flake

package/template/Readme.md

@@ -1,349 +0,0 @@
-# Gardener 🌱
-
-**Gardener** is a small development toolkit and micro-framework for building websites with **declarative DOM JSON**, server-rendered templates, and a **custom static site generation pipeline**.
-
-It is designed for developers who want:
-
-* full control over HTML structure
-* minimal abstractions
-* a fast local dev experience
-* a deterministic static output for production
-
-Gardener sits somewhere between a tiny framework and a build system.
-
----
-
-## What Gardener Includes
-
-### Core
-
-* 🌿 **gardener.js** — declarative DOM builder using JSON objects
-* 🔁 **parser** — convert real DOM elements back into gardener-compatible JSON
-* 📄 **EJS** for simple server-rendered views
-* 🎨 **Tailwind CSS** for fast styling
-
-### Dev Server
-
-* Express-based development server
-* Hot reload toggle (Ctrl + H)
-* Endpoints to create pages and components at runtime (dev convenience)
-
-### Images
-
-* Deterministic image optimization endpoint
-* Sharp-powered resize + WebP conversion
-* Filesystem cache reused during static builds
-
-### Static Site Generation (SSG)
-
-* Render EJS views into HTML
-* Convert route-encoded filenames into nested directories
-* Merge frontend assets and image cache
-* Clean temporary build artifacts
-* Produce a deployable static directory
-
----
-
-## Project Structure
-
-```
-src/
-├── backend/
-│   ├── routes/
-│   ├── controllers/
-│   ├── libs/
-│   ├── cache/              # generated image cache (build artifact)
-│   └── server.ts
-│
-├── frontend/
-│   ├── views/              # EJS templates (source)
-│   ├── assets/             # original images
-│   ├── components/
-│   ├── gardener.js
-│   └── styles/
-│
-├── frontendStatic/          # final static output (generated)
-└── tempfrontend/            # temporary build output (deleted after build)
-```
-
----
-
-## Requirements
-
-* Node.js v16+ (v18+ recommended)
-* pnpm (recommended) or npm
-* Optional: PostgreSQL
-
----
-
-## Quickstart (Development)
-
-### 1. Install
-
-```bash
-git clone https://github.com/ritishDas/Gardener.git
-cd Gardener
-pnpm install
-```
-
-### 2. Run dev server
-
-```bash
-pnpm run dev
-```
-
-* Server runs at **[http://localhost:3000](http://localhost:3000)**
-* Tailwind watcher and TypeScript server run together
-
----
-
-## Image Optimization & Caching
-
-Gardener provides a **deterministic image optimization endpoint**.
-
-### Route
-
-```
-GET /cache/:name
-```
-
-### Filename format
-
-```
-<basename>_<width>x<height>.webp
-```
-
-### Example
-
-```http
-GET /cache/hero_500x300.webp
-```
-
-HTML usage:
-
-```html
-<img src="/cache/hero_500x300.webp" alt="hero" />
-```
-
----
-
-### How it works
-
-1. Parses filename to extract:
-
-   * base name
-   * width
-   * height
-2. Checks cache:
-
-   ```
-   src/backend/cache/
-   ```
-3. If cached → return immediately
-4. If not cached:
-
-   * Finds source image in:
-
-     ```
-     src/frontend/assets/
-     ```
-   * Resizes and converts to WebP (Sharp)
-   * Stores result in cache
-5. Serves the optimized image
-
----
-
-### Static Build Integration
-
-During static generation:
-
-* All cached images under:
-
-  ```
-  src/backend/cache/
-  ```
-
-  are copied into:
-
-  ```
-  src/frontendStatic/
-  ```
-
-Static HTML can safely reference:
-
-```html
-<img src="/cache/hero_500x300.webp" />
-```
-
-No runtime image processing is required in production.
-
----
-
-## Static Site Generation
-
-Gardener includes a custom static build pipeline.
-
-### What it does
-
-1. Renders EJS views into HTML
-2. Writes temporary files using route-encoded filenames
-   (example: `_blog_posts_hello.html`)
-3. Converts them into directory-based routes:
-
-   ```
-   blog/posts/hello/index.html
-   ```
-4. Copies frontend assets
-5. Copies image cache
-6. Deletes temporary build directory
-
-### Output
-
-```
-src/frontendStatic/
-├── index.html
-├── blog/
-│   └── posts/
-│       └── hello/
-│           └── index.html
-├── assets/
-└── cache/
-```
-
-This directory is ready for:
-
-* static hosting
-* CDN deployment
-* Nginx / Caddy / Netlify / Vercel
-
----
-
-## Frontend API — `gardener.js`
-
-File: `src/frontend/gardener.js`
-
-### `gardener(obj)`
-
-Create DOM elements from JSON.
-
-```js
-const el = gardener({
-  t: 'div',
-  cn: ['card', 'p-4'],
-  children: [
-    { t: 'h2', txt: 'Title' },
-    { t: 'p', txt: 'Content' }
-  ]
-});
-
-document.body.appendChild(el);
-```
-
----
-
-### `parser(elementOrHtml, isParent = true)`
-
-Convert DOM into gardener JSON.
-
-```js
-const json = parser(document.querySelector('.hero'));
-console.log(json);
-```
-
----
-
-### `parserWindow(text)`
-
-Dev-only UI:
-
-* Preview parsed JSON
-* Press **Y** to create a component file
-
----
-
-### Utilities
-
-* `imagePreloader(images)`
-* `fetchElement(selector)`
-* `appendElement(parent, child)`
-* `replaceElement(original, newElem)`
-* `createElement(type, classname)`
-
----
-
-## Dev-Only Endpoints ⚠️
-
-### `POST /addcomponent`
-
-Creates a frontend component file.
-
-```json
-{
-  "path": "components/MyComp.js",
-  "component": "{ t: 'div', txt: 'Hello' }"
-}
-```
-
-Writes directly to the filesystem.
-
----
-
-### `POST /addpage`
-
-Creates an EJS page and registers a route.
-
-```json
-{ "page": "/my-page" }
-```
-
-* Generates a new EJS file
-* Appends a route to the backend router
-
----
-
-## Security Notes
-
-⚠️ **Important**
-
-* `/addcomponent` and `/addpage` mutate files and routes
-* Intended for **local development only**
-* Do NOT expose publicly without authentication and sanitization
-
----
-
-## Troubleshooting
-
-* **Server not starting**
-
-  * Check `.env`
-  * Ensure PostgreSQL is running (if enabled)
-  * Inspect logs from `pnpm run dev`
-
-* **Images not loading**
-
-  * Ensure source image exists in `src/frontend/assets`
-  * Filename must match `<name>_<width>x<height>.webp`
-
-* **Tailwind not updating**
-
-  * Ensure `pnpm install` completed successfully
-
----
-
-## Contributing
-
-This is a small personal/dev-focused toolkit.
-
-Contributions are welcome:
-
-* bug fixes
-* documentation improvements
-* build pipeline enhancements
-* security hardening
-
----
-
-## License
-
-MIT
-

package/template/src/frontend/components/emailsvg.js

@@ -1,55 +0,0 @@
-
-import { gardener, fetchElement, replaceElement } from '../gardener.js'
-
-export default function thisfun() {
-  return gardener({
-  "t": "span",
-  "cn": [
-    "emailsvg"
-  ],
-  "children": [
-    {
-      "t": "svg",
-      "cn": [
-        "icon",
-        "icon-tabler",
-        "icons-tabler-outline",
-        "icon-tabler-mail"
-      ],
-      "attr": {
-        "xmlns": "http://www.w3.org/2000/svg",
-        "width": "24",
-        "height": "24",
-        "viewBox": "0 0 24 24",
-        "fill": "none",
-        "stroke": "currentColor",
-        "stroke-width": "2",
-        "stroke-linecap": "round",
-        "stroke-linejoin": "round"
-      },
-      "children": [
-        {
-          "t": "path",
-          "attr": {
-            "stroke": "none",
-            "d": "M0 0h24v24H0z",
-            "fill": "none"
-          }
-        },
-        {
-          "t": "path",
-          "attr": {
-            "d": "M3 7a2 2 0 0 1 2 -2h14a2 2 0 0 1 2 2v10a2 2 0 0 1 -2 2h-14a2 2 0 0 1 -2 -2v-10"
-          }
-        },
-        {
-          "t": "path",
-          "attr": {
-            "d": "M3 7l9 6l9 -6"
-          }
-        }
-      ]
-    }
-  ]
-})
-}

package/template/src/frontend/components/eyeon.js

@@ -1,44 +0,0 @@
-
-import { gardener } from '../gardener.js'
-
-export default function () {
-  return gardener({
-  "t": "svg",
-  "cn": [
-    "eye"
-  ],
-  "attr": {
-    "xmlns": "http://www.w3.org/2000/svg",
-    "width": "24",
-    "height": "24",
-    "viewBox": "0 0 24 24",
-    "fill": "none",
-    "stroke": "currentColor",
-    "stroke-width": "2",
-    "stroke-linecap": "round",
-    "stroke-linejoin": "round"
-  },
-  "children": [
-    {
-      "t": "path",
-      "attr": {
-        "stroke": "none",
-        "d": "M0 0h24v24H0z",
-        "fill": "none"
-      }
-    },
-    {
-      "t": "path",
-      "attr": {
-        "d": "M10 12a2 2 0 1 0 4 0a2 2 0 0 0 -4 0"
-      }
-    },
-    {
-      "t": "path",
-      "attr": {
-        "d": "M21 12c-2.4 4 -5.4 6 -9 6c-3.6 0 -6.6 -2 -9 -6c2.4 -4 5.4 -6 9 -6c3.6 0 6.6 2 9 6"
-      }
-    }
-  ]
-})
-}

package/template/src/frontend/components/test.js

@@ -1,54 +0,0 @@
-
-import { gardener, fetchElement, replaceElement } from '../gardener.js'
-
-export default function thisfun() {
-  return gardener({
-  "t": "div",
-  "attr": {
-    "id": "body"
-  },
-  "children": [
-    {
-      "t": "div",
-      "cn": [
-        "h-screen",
-        "w-screen",
-        "bg-white",
-        "loader",
-        "absolute"
-      ],
-      "attr": {
-        "style": "transition: 0.4s; opacity: 0;"
-      },
-      "txt": ""
-    },
-    {
-      "t": "div",
-      "cn": [
-        "hero",
-        "flex",
-        "justify-around",
-        "items-center",
-        "p-5",
-        "h-[90vh]"
-      ],
-      "children": [
-        {
-          "t": "p",
-          "cn": [
-            "p-5"
-          ],
-          "txt": "Gardener is a front-end library for creating and manipulating DOM elements using a declarative JavaScript object syntax. It includes a development server with features like timely reload and on-the-fly component creation from existing HTML. The server also provides dynamic image resizing and caching."
-        },
-        {
-          "t": "img",
-          "attr": {
-            "src": "/cache/gardener_500x500.webp",
-            "alt": "logo"
-          }
-        }
-      ]
-    }
-  ]
-})
-}