Skip to content

Diagnostics

Diagnostics

Every LUMxxxx code the Lumiose tools report, with its long-form explanation.

Codes are stable forever and never reused. Print one with lumiose explain LUM1004, or open errors/LUM1004.md. Each diagnostic carries { code, severity, message, span, labels, help, fix?, docs }; lumiose check --format json prints them.

#File format (1xxx)

Code	Severity	Title
LUM1001	error	Syntax error
LUM1002	error	Unsupported by this compiler version
LUM1003	warning	Scanner ambiguity
LUM1004	error	Unclosed `<style>` block
LUM1005	error	Unknown `<style>` attribute
LUM1006	error	Raw CSS in a `.tsx` file
LUM1007	error	`await using` in a component
LUM1008	error	`<script>` in a Markdown file
LUM1009	error	Content nested too deeply
LUM1010	error	Source nested too deeply

#Reactivity (2xxx)

Code	Severity	Title
LUM2001	warning	Stale derived value
LUM2002	error	Signal write during render
LUM2003	error	Reactive early return
LUM2004	error	Component called as a function
LUM2005	warning	Children inserted twice
LUM2006	warning	Reactive index escapes its callback
LUM2007	warning	Own signal read in an async body
LUM2008	warning	Unsupported list key

#Styles (3xxx)

Code	Severity	Title
LUM3005	warning	Unused scoped selector
LUM3008	error	Non-constant `$` reference
LUM3009	error	Hyphenated `$` reference
LUM3010	error	Misplaced `<style>` block
LUM3011	error	`<style>` as the root or in an expression
LUM3012	warning	Custom property set but never read
LUM3013	error	`$` reference before its declaration
LUM3014	error	CSS syntax error
LUM3015	warning	Invalid CSS ignored
LUM3016	error	Invalid `:global()` or `:deep()` selector
LUM3017	warning	Invalid CSS value
LUM3018	warning	Unitless number from a `$` reference
LUM3019	warning	Unit separated from a `$` reference
LUM3020	warning	Unknown CSS property
LUM3021	error	Unsafe `$` constant value

#Islands and boundaries (4xxx)

Code	Severity	Title
LUM4001	error	Island component is not exported
LUM4002	error	Non-serializable island prop
LUM4003	error	Server-only module in a client graph
LUM4004	warning	Browser API at module scope
LUM4006	error	Hydration mismatch
LUM4007	error	Non-serializable awaited value
LUM4008	warning	Module-scope signal written during SSR
LUM4009	warning	Unsafe URL blocked in a URL attribute
LUM4010	warning	Island reads context provided by the page
LUM4011	error	Non-serializable scoped state value

#Routing and server (5xxx)

Code	Severity	Title
LUM5001	error	Request API used during prerender
LUM5002	error	Invalid route file
LUM5003	error	Duplicate route
LUM5004	error	Head or status change inside a streamed boundary
LUM5005	error	Non-GET method in a static endpoint
LUM5006	error	Prerendered page that renders only in the browser
LUM5007	error	Route param named `locale`
LUM5008	warning	Folder middleware covering prerendered routes
LUM5009	error	Boundary still pending when streamTimeout expired

#Tooling and config (6xxx)

Code	Severity	Title
LUM6001	warning	tsconfig missing options required by Lumiose