xpltdco/kerf-engine
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
34 commits 1 branch 0 tags 5.8 MiB
Commit graph

34 commits

This branch
This branch
All branches
Author SHA1 Message Date
jlightner
fdcff9ea14 chore: remove .gsd/ from tracking, add to .gitignore 2026-04-13 23:50:11 -05:00
jlightner
480f7a4652 feat: Added B&W/grayscale/color conversion modes, invert toggle, 10+ mode-aware sliders, mask regions, turnpolicy, and white preview background 
Engine:
- preprocess() accepts conversion_mode (bw/grayscale/color), invert, mask_regions
- B&W: full pipeline → binary; Grayscale: skip threshold → 8-bit; Color: skip grayscale → BGR
- routes.py forces VTracer for non-binary modes, sets colormode appropriately
- potrace_trace() accepts turnpolicy param mapped to potrace constants
- 27 new tests in test_modes.py (modes, invert, masks, params, vectorization)

App:
- Mode selector tabs (B&W | Grayscale | Color) in ImportConvert
- Invert toggle (B&W only)
- ParameterSliders rewritten: grouped sections, 10+ mode-aware controls
- Debounce reduced from 300ms to 100ms
- Preview background changed to white
- Preset JSONs updated with turnpolicy, color_precision, layer_difference defaults

Tests: 126 app + 234 engine = 360 total, all pass. Zero TypeScript errors.
 2026-03-26 08:41:30 +00:00
jlightner
60b48b041e chore: auto-commit after complete-milestone 
GSD-Unit: M003
 2026-03-26 07:12:51 +00:00
jlightner
6adeb770bf test: Added embed demo page with style-isolation proof, 6 setEngineBase… 
- "examples/embed-demo.html"
- "app/src/api/__tests__/engine.test.ts"
- "vite.embed.config.ts"
- ".gitignore"

GSD-Task: S03/T02
 2026-03-26 07:03:02 +00:00
jlightner
e20de2166c feat: Added setEngineBaseUrl() to engine API client, created <kerf-embe… 
- "app/src/api/engine.ts"
- "app/src/embed.tsx"
- "app/vite.embed.config.ts"
- "app/tsconfig.node.json"

GSD-Task: S03/T01
 2026-03-26 06:59:49 +00:00
jlightner
c1d4001e9a docs: Rewrote README.md with 8 sections: quick start, repo structure, a… 
- "README.md"

GSD-Task: S02/T02
 2026-03-26 06:46:20 +00:00
jlightner
06b6045d8c feat: Create Dockerfile.app (node→nginx multi-stage), nginx.conf (SPA +… 
- "docker/Dockerfile.app"
- "docker/nginx.conf"
- "docker-compose.yml"

GSD-Task: S02/T01
 2026-03-26 06:43:59 +00:00
jlightner
c60dd59c01 feat: Built complete ExportView with DXF/SVG/PNG format selector, valid… 
- "app/src/views/ExportView.tsx"
- "app/src/views/ExportView.module.css"
- "app/src/App.tsx"

GSD-Task: S01/T04
 2026-03-26 06:29:21 +00:00
jlightner
75217ea6cb test: Created exportService.ts with composeCanvasSVG(), validateForExpo… 
- "app/src/utils/exportService.ts"
- "app/src/utils/__tests__/exportService.test.ts"
- "app/src/api/engine.ts"
- "app/src/api/__tests__/engine.test.ts"
- "app/src/types/opentype.d.ts"

GSD-Task: S01/T03
 2026-03-26 06:26:09 +00:00
jlightner
2bcc124542 feat: Lifted useCanvasState() from DesignCanvas to App.tsx, threaded al… 
- "app/src/App.tsx"
- "app/src/views/DesignCanvas.tsx"

GSD-Task: S01/T02
 2026-03-26 06:19:30 +00:00
jlightner
4fad89288e feat: Extended generate_dxf() with units/scale_factor/layer_map params… 
- "engine/output/dxf.py"
- "engine/api/routes.py"
- "engine/tests/test_output.py"

GSD-Task: S01/T01
 2026-03-26 06:17:06 +00:00
jlightner
17bb1ab0ef chore: auto-commit after complete-milestone 
GSD-Unit: M002
 2026-03-26 06:07:21 +00:00
jlightner
46169ecf02 feat: Added text-specific property controls (content, font family, size… 
- "app/src/components/canvas/ShapeProperties.tsx"
- "app/src/views/DesignCanvas.tsx"

GSD-Task: S03/T03
 2026-03-26 05:58:10 +00:00
jlightner
40690e9c80 test: Added TextObject to CanvasObject union and wired text tool into K… 
- "app/src/types/canvas.ts"
- "app/src/components/canvas/KonvaStage.tsx"
- "app/src/components/canvas/CanvasToolbar.tsx"
- "app/src/components/canvas/ObjectPanel.tsx"
- "app/src/components/canvas/ShapeProperties.tsx"
- "app/src/components/canvas/AlignmentBar.tsx"

GSD-Task: S03/T02
 2026-03-26 05:55:47 +00:00
jlightner
ff246b3d52 test: Built fontService with opentype.js font loading, caching, text-to… 
- "app/src/utils/fontService.ts"
- "app/src/utils/__tests__/fontService.test.ts"
- "app/public/fonts/Roboto-Regular.ttf"
- "app/public/fonts/OpenSans-Regular.ttf"
- "app/public/fonts/Lato-Regular.ttf"
- "app/src/App.css"
- "app/package.json"

GSD-Task: S03/T01
 2026-03-26 05:53:04 +00:00
jlightner
4215ef7b8c test: Add canvas keyboard shortcuts (undo/redo/delete/select-all/desele… 
- "app/src/views/DesignCanvas.tsx"

GSD-Task: S02/T04
 2026-03-26 05:41:41 +00:00
jlightner
a37b52eefa feat: Built four canvas UI panels (ObjectPanel, AlignmentBar, CanvasToo… 
- "app/src/components/canvas/ObjectPanel.tsx"
- "app/src/components/canvas/AlignmentBar.tsx"
- "app/src/components/canvas/CanvasToolbar.tsx"
- "app/src/components/canvas/ShapeProperties.tsx"
- "app/src/views/DesignCanvas.tsx"
- "app/src/App.css"

GSD-Task: S02/T03
 2026-03-26 05:40:13 +00:00
jlightner
6ec52ab7b6 feat: Built KonvaStage with artboard rendering, shape tools, selection… 
- "app/src/components/canvas/KonvaStage.tsx"
- "app/src/views/DesignCanvas.tsx"
- "app/src/views/DesignCanvas.module.css"
- "app/src/App.tsx"
- "app/src/App.css"

GSD-Task: S02/T02
 2026-03-26 05:36:19 +00:00
jlightner
59a034ab75 test: Built canvas type system, useCanvasState hook with undo/redo, art… 
- "app/src/types/canvas.ts"
- "app/src/hooks/useCanvasState.ts"
- "app/src/hooks/__tests__/useCanvasState.test.ts"
- "app/src/utils/artboardShapes.ts"
- "app/src/utils/__tests__/artboardShapes.test.ts"
- "app/src/utils/alignment.ts"
- "app/src/utils/__tests__/alignment.test.ts"
- "app/src/components/canvas/ArtboardSetup.tsx"

GSD-Task: S02/T01
 2026-03-26 05:32:04 +00:00
jlightner
a97629c390 test: Created OutputInfoBar with color-coded stats, wired Use This butt… 
- "app/src/components/OutputInfoBar.tsx"
- "app/src/components/__tests__/OutputInfoBar.test.tsx"
- "app/src/views/ImportConvert.tsx"
- "app/src/App.css"

GSD-Task: S01/T04
 2026-03-26 05:17:48 +00:00
jlightner
fc63195d68 feat: Built useDebouncedTrace hook with AbortController cancellation, P… 
- "app/src/hooks/useDebouncedTrace.ts"
- "app/src/components/ParameterSliders.tsx"
- "app/src/components/SvgPreview.tsx"
- "app/src/views/ImportConvert.tsx"
- "app/src/hooks/__tests__/useDebouncedTrace.test.ts"
- "app/src/App.css"
- "app/src/App.tsx"

GSD-Task: S01/T03
 2026-03-26 05:15:43 +00:00
jlightner
16d336913f feat: Built app shell with ViewState routing, drag-and-drop FileUpload… 
- "app/src/App.tsx"
- "app/src/App.css"
- "app/src/views/ImportConvert.tsx"
- "app/src/views/ImportConvert.module.css"
- "app/src/components/FileUpload.tsx"
- "app/src/components/PresetSelector.tsx"

GSD-Task: S01/T02
 2026-03-26 05:07:37 +00:00
jlightner
9be90a4494 test: Added CORSMiddleware to engine, scaffolded Vite+React+TS app with… 
- "engine/main.py"
- "app/vite.config.ts"
- "app/src/types/engine.ts"
- "app/src/api/engine.ts"
- "app/src/api/__tests__/engine.test.ts"
- "app/src/App.tsx"
- "app/src/test-setup.ts"
- "app/tsconfig.app.json"

GSD-Task: S01/T01
 2026-03-26 05:05:31 +00:00
jlightner
c3c5a9b082 chore: auto-commit after complete-milestone 
GSD-Unit: M001
 2026-03-26 04:57:16 +00:00
jlightner
2d8efb15dd feat: Created multi-stage Dockerfile.engine with healthcheck endpoint;… 
- "docker/Dockerfile.engine"
- "engine/api/routes.py"
- ".dockerignore"

GSD-Task: S03/T02
 2026-03-26 04:49:38 +00:00
jlightner
c693f5e1e2 fix: Implemented 5 preset configs (sign, patch, stencil, detailed, cust… 
- "engine/presets/sign.json"
- "engine/presets/patch.json"
- "engine/presets/stencil.json"
- "engine/presets/detailed.json"
- "engine/presets/custom.json"
- "engine/presets/loader.py"
- "engine/api/routes.py"
- "engine/tests/test_presets.py"

GSD-Task: S03/T01
 2026-03-26 04:45:52 +00:00
jlightner
9540f37f70 test: Wire post-processing into /engine/trace, add output_format routin… 
- "engine/api/routes.py"
- "engine/tests/test_api.py"

GSD-Task: S02/T03
 2026-03-26 04:39:52 +00:00
jlightner
4539a488bc fix: Implemented RDP path simplification, island/hole detection via win… 
- engine/pipeline/postprocess.py
- engine/tests/test_postprocess.py

GSD-Task: S02/T01
 2026-03-26 04:32:31 +00:00
jlightner
291a810605 test: Wired POST /engine/trace endpoint with preprocess + vectorize pip… 
- "engine/api/routes.py"
- "engine/tests/test_api.py"
- "engine/main.py"

GSD-Task: S01/T05
 2026-03-26 04:22:39 +00:00
jlightner
ae74228fb0 test: Implemented vtracer_trace() function that converts grayscale or c… 
- engine/pipeline/vectorize.py
- engine/tests/test_vectorize.py

GSD-Task: S01/T04
 2026-03-26 04:18:31 +00:00
jlightner
a12646de89 test: Implemented potrace_trace() function that converts preprocessed b… 
- engine/pipeline/vectorize.py
- engine/tests/test_vectorize.py

GSD-Task: S01/T03
 2026-03-26 04:15:01 +00:00
jlightner
c20d6e55b6 test: Implemented full OpenCV preprocessing pipeline (grayscale, bilate… 
- engine/pipeline/preprocessing.py
- engine/tests/test_preprocessing.py

GSD-Task: S01/T02
 2026-03-26 04:11:01 +00:00
jlightner
da8e1c152a chore: Created engine/ Python project with FastAPI skeleton, all depend… 
- "engine/pyproject.toml"
- "engine/main.py"
- "engine/.gitignore"
- "README.md"

GSD-Task: S01/T01
 2026-03-26 04:07:16 +00:00
jlightner
3cca4a2350 init: GSD project scaffolding for Kerf — 3 milestones, requirements, decisions 
M001: Kerf Engine (pipeline, API, presets, Docker) — 3 slices, 10 tasks
M002: Kerf App (Import UI, Canvas, Text system) — 3 slices (planned, not detailed)
M003: Export, Docker Compose, Embed Mode — 3 slices (planned, not detailed)

25 requirements extracted from GSD-INITIATE.md
7 architectural decisions recorded
Human checkpoints gate M001→M002→M003 transitions
 2026-03-26 03:55:59 +00:00