From d9db2a771da05497da6494af086f2c26acba29a1 Mon Sep 17 00:00:00 2001
From: Thomas Nilles <thomas@nilles.net>
Date: Tue, 13 Jan 2026 01:38:15 -0500
Subject: [PATCH] update

---
 .gitignore                                    |   5 +
 Dockerfile                                    |  24 +++++
 docker-compose.yaml                           |  11 ++
 static/components/AGENT_GUIDE.md              | 101 ++++++++++++++++++
 .../canvas-display/canvas-display.html        |  38 +++++++
 .../components/color-picker/color-picker.html |  29 +++++
 .../grid-selector/grid-selector.html          |  41 +++++++
 static/components/side-menu/side-menu.html    |  43 ++++++++
 static/components/toolbar/toolbar.html        |  42 ++++++++
 static/index.html                             |   0
 10 files changed, 334 insertions(+)
 create mode 100644 Dockerfile
 create mode 100644 docker-compose.yaml
 create mode 100644 static/components/AGENT_GUIDE.md
 create mode 100644 static/components/canvas-display/canvas-display.html
 create mode 100644 static/components/color-picker/color-picker.html
 create mode 100644 static/components/grid-selector/grid-selector.html
 create mode 100644 static/components/side-menu/side-menu.html
 create mode 100644 static/components/toolbar/toolbar.html
 create mode 100644 static/index.html

diff --git a/.gitignore b/.gitignore
index 3ef4dc6..0e10d66 100644
--- a/.gitignore
+++ b/.gitignore
@@ -45,6 +45,11 @@ go.work.sum
 !*.go
 !go.sum
 !go.mod
+!Dockerfile
+!docker-compose.yaml
+!air.toml
+!*.html
+!*.md
 
 !README.md
 !LICENSE
diff --git a/Dockerfile b/Dockerfile
new file mode 100644
index 0000000..34ad7a0
--- /dev/null
+++ b/Dockerfile
@@ -0,0 +1,24 @@
+# Use the official Golang image as the base.
+FROM golang:1.22-alpine AS base
+
+# Install git (required by go modules) and any other utilities.
+RUN apk add --no-cache git
+
+
+
+
+
+# Set the working directory inside the container.
+WORKDIR /app
+
+# Cache go.mod and go.sum to speed up dependency installation.
+COPY go.mod go.sum ./
+RUN go mod download
+
+# Copy the rest of the source code.
+COPY . .
+# Build the binary after copying the source files.
+RUN go build -o /app/tmp/main ./cmd/app
+
+# The container will start Air, which watches the source files and rebuilds the app on change.
+CMD ["./tmp/main"]
diff --git a/docker-compose.yaml b/docker-compose.yaml
new file mode 100644
index 0000000..3253904
--- /dev/null
+++ b/docker-compose.yaml
@@ -0,0 +1,11 @@
+services:
+  app:
+    build:
+      context: .
+      dockerfile: Dockerfile
+
+    ports:
+      - "8080:8080"
+    environment:
+      - GO111MODULE=on
+    command: ["./tmp/main"]
diff --git a/static/components/AGENT_GUIDE.md b/static/components/AGENT_GUIDE.md
new file mode 100644
index 0000000..45495a4
--- /dev/null
+++ b/static/components/AGENT_GUIDE.md
@@ -0,0 +1,101 @@
+# Agent Guide – Front‑End Web Components
+
+## Purpose
+This guide defines the conventions we follow for building the front‑end of the **draw‑tools** project using **custom HTML web components**.  
+
+## Rules
+
+1. **Only custom web components**  
+   - All UI elements must be implemented as native HTML custom elements (`<my‑component>`).  
+   - No third‑party UI libraries (e.g., React, Vue) are used.
+
+2. **Self‑contained components**  
+   - Each component lives in its own folder under `static/components`.  
+   - The folder contains:
+     - `my-component.html` – the HTML template (including `<template>` tag).  
+     - `my-component.js` – the class definition that registers the element.  
+     - Optional `my-component.css` – scoped styles imported by the HTML template.  
+     - `README.md` – usage instructions and a change‑log for that component.
+
+3. **One markdown file per component**  
+   - Inside each component folder, `README.md` documents:
+     - How to import the component in a page.  
+     - Public attributes, properties, and events.  
+     - Example markup.  
+     - A chronological **Change Log** (date, author, description).
+
+4. **Directory structure & naming**  
+   ```
+   draw-tools/
+   └─ static/
+      └─ components/
+         ├─ my-button/
+         │   ├─ my-button.html
+         │   ├─ my-button.js
+         │   ├─ my-button.css   (optional)
+         │   └─ README.md
+         ├─ my-card/
+         │   └─ … (same pattern)
+         └─ AGENT_GUIDE.md      ← this file
+   ```
+   - Folder name = kebab‑case version of the component name.  
+   - File names match the component name (e.g., `my-button.html`).
+
+5. **Component registration**  
+   ```js
+   class MyButton extends HTMLElement {
+     constructor() { super(); /* … */ }
+     /* lifecycle callbacks, methods, etc. */
+   }
+   customElements.define('my-button', MyButton);
+   ```
+   - The registration must happen **once** per component (usually at the end of the `.js` file).
+
+6. **Styling**  
+   - Use the Shadow DOM to encapsulate styles.  
+   - If a separate `.css` file is present, import it inside the HTML template:
+     ```html
+     <style>@import "./my-button.css";</style>
+     ```
+
+7. **Documentation updates**  
+   - Whenever a component is added, modified, or removed, update its `README.md` and the **Change Log** section at the bottom of the file.  
+   - Keep this `AGENT_GUIDE.md` up‑to‑date with any new rules.
+
+## Example Component Layout
+
+```
+static/components/my-button/
+│
+├─ my-button.html      ← <template> with markup and optional <style>
+├─ my-button.js        ← class definition + registration
+├─ my-button.css       ← (optional) scoped CSS
+└─ README.md           ← usage guide & change log
+```
+
+### Sample `README.md` (inside `my-button`)
+
+```markdown
+# MyButton Component
+
+## Usage
+```html
+<script type="module" src="/static/components/my-button/my-button.js"></script>
+<my-button label="Click me"></my-button>
+```
+
+## Attributes / Properties
+- `label` (string) – Text displayed inside the button.
+
+## Events
+- `click` – dispatched when the button is pressed.
+
+## Change Log
+| Date       | Author | Change |
+|------------|--------|--------|
+| 2026‑01‑11 | Thomas | Initial creation |
+```
+
+---
+
+**Keep this guide** in the repo root of the components folder so any new team member can quickly understand the structure and expectations.
\ No newline at end of file
diff --git a/static/components/canvas-display/canvas-display.html b/static/components/canvas-display/canvas-display.html
new file mode 100644
index 0000000..f38ba21
--- /dev/null
+++ b/static/components/canvas-display/canvas-display.html
@@ -0,0 +1,38 @@
+<template id="canvas-display-template">
+  <style></style>
+    :host {
+      display: block;
+      position: relative;
+      font-family: sans-serif;
+    }
+
+    .canvas-wrapper {
+      position: relative;
+      width: 100%;
+      height: 100%;
+      overflow: hidden;
+    }
+
+    canvas {
+      display: block;
+      width: 100%;
+      height: 100%;
+      background: var(--bg-color, #ffffff);
+    }
+
+    /* grid overlay */
+    .grid-overlay {
+      position: absolute;
+      top: 0;
+      left: 0;
+      width: 100%;
+      height: 100%;
+      pointer-events: none;
+    }
+  </style>
+
+  <div class="canvas-wrapper">
+    <canvas id="draw-canvas"></canvas>
+    <svg class="grid-overlay" id="grid-overlay"></svg>
+  </div>
+</template>
diff --git a/static/components/color-picker/color-picker.html b/static/components/color-picker/color-picker.html
new file mode 100644
index 0000000..4fd4b9d
--- /dev/null
+++ b/static/components/color-picker/color-picker.html
@@ -0,0 +1,29 @@
+<template id="color-picker-template">
+  <style></style>
+    :host {
+      display: inline-block;
+      font-family: sans-serif;
+    }
+    .wrapper {
+      display: flex;
+      align-items: center;
+      gap: 0.5rem;
+    }
+    input[type="color"] {
+      border: none;
+      width: 2rem;
+      height: 2rem;
+      padding: 0;
+      background: none;
+    }
+    label {
+      font-size: 0.9rem;
+      user-select: none;
+    }
+  </style>
+
+  <div class="wrapper">
+    <label for="color-input">Background:</label>
+    <input type="color" id="color-input" value="#ffffff">
+  </div>
+</template>
diff --git a/static/components/grid-selector/grid-selector.html b/static/components/grid-selector/grid-selector.html
new file mode 100644
index 0000000..2b77e6d
--- /dev/null
+++ b/static/components/grid-selector/grid-selector.html
@@ -0,0 +1,41 @@
+<template id="grid-selector-template">
+  <style></style>
+    :host {
+      display: inline-block;
+      font-family: sans-serif;
+    }
+
+    .wrapper {
+      display: flex;
+      align-items: center;
+      gap: 0.5rem;
+    }
+
+    label {
+      font-size: 0.9rem;
+      user-select: none;
+    }
+
+    input[type="color"],
+    input[type="number"] {
+      border: none;
+      padding: 0;
+      background: none;
+    }
+
+    input[type="checkbox"] {
+      margin: 0;
+    }
+  </style>
+
+  <div class="wrapper">
+    <label for="grid-color">Grid color:</label>
+    <input type="color" id="grid-color" value="#000000">
+
+    <label for="grid-size">Size:</label>
+    <input type="number" id="grid-size" min="5" step="5" value="25">
+
+    <label for="grid-numbering">Numbering:</label>
+    <input type="checkbox" id="grid-numbering" checked>
+  </div>
+</template>
diff --git a/static/components/side-menu/side-menu.html b/static/components/side-menu/side-menu.html
new file mode 100644
index 0000000..1242259
--- /dev/null
+++ b/static/components/side-menu/side-menu.html
@@ -0,0 +1,43 @@
+<template id="side-menu-template">
+  <style></style>
+    :host {
+      display: block;
+      width: var(--side-menu-width, 250px);
+      height: 100%;
+      background: var(--side-menu-bg, #f9f9f9);
+      border-right: 1px solid #ccc;
+      box-sizing: border-box;
+      position: relative;
+      transition: transform 0.3s ease;
+    }
+
+    .menu {
+      height: 100%;
+      overflow-y: auto;
+    }
+
+    .toggle {
+      position: absolute;
+      top: 0.5rem;
+      right: -1.5rem;
+      background: var(--toggle-bg, #f0f0f0);
+      border: 1px solid #ccc;
+      border-left: none;
+      border-radius: 0 4px 4px 0;
+      padding: 0.25rem 0.5rem;
+      cursor: pointer;
+      user-select: none;
+    }
+
+    .collapsed {
+      transform: translateX(-100%);
+    }
+  </style>
+
+  <div class="toggle" part="toggle">☰</div>
+  <nav class="menu" part="menu">
+    <slot></slot>
+    <color-picker></color-picker>
+    <label id="grid-toggle-label"><input type="checkbox" id="grid-toggle"> Grid</label>
+  </nav>
+</template>
diff --git a/static/components/toolbar/toolbar.html b/static/components/toolbar/toolbar.html
new file mode 100644
index 0000000..da3234a
--- /dev/null
+++ b/static/components/toolbar/toolbar.html
@@ -0,0 +1,42 @@
+<template id="toolbar-template">
+  <style></style>
+    :host {
+      display: block;
+      width: 100%;
+      background: #f0f0f0;
+      border-bottom: 1px solid #ccc;
+      box-sizing: border-box;
+      font-family: sans-serif;
+    }
+
+    .toolbar {
+      display: flex;
+      align-items: center;
+      gap: 1rem;
+      padding: 0.5rem 1rem;
+    }
+
+    .section {
+      display: flex;
+      align-items: center;
+      gap: 0.5rem;
+    }
+
+    .section > label {
+      font-size: 0.9rem;
+      user-select: none;
+    }
+  </style>
+
+  <div class="toolbar">
+    <div class="section" id="bg-section">
+      <label for="bg-picker">Background:</label>
+      <slot name="bg-picker"></slot>
+    </div>
+
+    <div class="section" id="grid-section">
+      <label for="grid-picker">Grid:</label>
+      <slot name="grid-picker"></slot>
+    </div>
+  </div>
+</template>
diff --git a/static/index.html b/static/index.html
new file mode 100644
index 0000000..e69de29