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

31 commits

This branch
This branch
All branches
Author SHA1 Message Date
jlightner
fae0d107e7 chore: remove .gsd/ from tracking, add to .gitignore 2026-04-13 23:50:11 -05:00
jlightner
31f78727e0 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
87fa4eff91 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
7fbd909646 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
5a0b8679a0 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
80ca11409c 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
8ef0d4bf01 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
fa4c765860 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
62c866be84 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
6c8c31e13b 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
868b444595 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
24fb28d622 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
ab170d8d20 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
0dcc96dee6 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
e38a7c5cf2 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
4b049c9c0f 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
62f79110e8 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
383825e242 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
c3783e1680 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
35bc542aad 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
fda6bfbafc 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
1f1629e6e9 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
32eb02ccb6 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
0c197f5497 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
6d51628ce8 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
a91c99dd6c 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
b33e883a6b 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
136a9417f9 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
816ba43cd6 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
7411bf3ed4 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
1adcbb3348 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