Scott.Idem/OSIT-AE-App-Svelte
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add mistake #19 — optional TypeScript params break vite build SSR

Browse Source 
Documents the param?: Type pattern that esbuild mishandles in .svelte
files (strips the type but leaves ?, producing invalid JavaScript). Adds
the full write-up to REFERENCE__Common_Agent_Mistakes.md and a summary
entry #10 to BOOTSTRAP__AI_Agent_Quickstart.md §7.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Scott Idem
2026-06-22 19:04:52 -04:00
parent 3bc93857dd
commit 6c822bc466
2 changed files with 49 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

3
documentation/BOOTSTRAP__AI_Agent_Quickstart.md
View File

@@ -308,6 +308,9 @@ Read this section first, then open the reference doc when your task touches one
field, SWR-await-after-write races, and stateful/conditional sync gates that desync local
state from history rather than current config. See the Pres Mgmt Config sync overhaul
(2026-06-16) in `PROJECT__AE_Events_PressMgmt_Config_Cleanup.md` for the full incident.
10. **`param?: Type` in `.svelte` function/snippet parameters** — breaks `vite build` (SSR step)
silently: dev server is fine, Docker/production builds fail with "Expected ',', got '?'".
Use `param: Type | undefined = undefined` instead. See mistake #19 in the reference doc.
The reference doc also includes a short archive list for older, less-relevant historical incidents.