add numeric input view; wire step/locale; update demo/docs; remove DATA_GRID_PLAN

Author: mike-ward

README.md

@@ -167,6 +167,7 @@ v run examples/dialogs.v        # Custom + native dialogs
 v run examples/split_panel.v    # Splitter + nested splitter
 v run examples/printing.v       # PDF export + native print
 v run examples/input_masks.v    # Input mask presets and custom tokens
+v run examples/numeric_input.v  # Locale-aware numeric input + step controls
 v run examples/text_transform.v # Rotated and affine text
 v run examples/table_demo.v     # Table widget demo
 v run examples/data_grid_demo.v # Data grid widget demo

_view_numeric_input_test.v

@@ -0,0 +1,110 @@
+module gui
+
+import math
+
+fn test_numeric_parse_en_locale() {
+	value := numeric_parse('1,234.50', NumericLocaleCfg{}) or {
+		assert false
+		return
+	}
+	assert math.abs(value - 1234.5) < 0.000001
+}
+
+fn test_numeric_parse_de_locale() {
+	locale := NumericLocaleCfg{
+		decimal_sep: `,`
+		group_sep:   `.`
+	}
+	value := numeric_parse('1.234,50', locale) or {
+		assert false
+		return
+	}
+	assert math.abs(value - 1234.5) < 0.000001
+}
+
+fn test_numeric_parse_invalid_string() {
+	assert numeric_parse('1,,234', NumericLocaleCfg{}) == none
+	assert numeric_parse('abc', NumericLocaleCfg{}) == none
+}
+
+fn test_numeric_format_en_locale() {
+	assert numeric_format(1234.5, 2, NumericLocaleCfg{}) == '1,234.50'
+}
+
+fn test_numeric_format_de_locale() {
+	locale := NumericLocaleCfg{
+		decimal_sep: `,`
+		group_sep:   `.`
+	}
+	assert numeric_format(1234.5, 2, locale) == '1.234,50'
+}
+
+fn test_numeric_format_group_sizes() {
+	locale := NumericLocaleCfg{
+		group_sep:   `,`
+		group_sizes: [3, 2]
+	}
+	assert numeric_format(1234567, 0, locale) == '12,34,567'
+}
+
+fn test_numeric_commit_result_clamps() {
+	value, text := numeric_input_commit_result('1,250.30', none, 0.0, 1000.0, 2, NumericLocaleCfg{})
+	assert text == '1,000.00'
+	if parsed := value {
+		assert math.abs(parsed - 1000.0) < 0.000001
+	} else {
+		assert false
+	}
+}
+
+fn test_numeric_commit_result_invalid_fallback_to_value() {
+	value, text := numeric_input_commit_result('abc', 12.5, none, none, 1, NumericLocaleCfg{})
+	assert text == '12.5'
+	if parsed := value {
+		assert math.abs(parsed - 12.5) < 0.000001
+	} else {
+		assert false
+	}
+}
+
+fn test_numeric_commit_result_invalid_without_value() {
+	value, text := numeric_input_commit_result('abc', none, none, none, 2, NumericLocaleCfg{})
+	assert value == none
+	assert text == ''
+}
+
+fn test_numeric_step_result_uses_min_seed() {
+	value, text := numeric_input_step_result('', none, 10.0, none, 2, NumericStepCfg{},
+		NumericLocaleCfg{}, 1.0, .none)
+	assert text == '11.00'
+	if parsed := value {
+		assert math.abs(parsed - 11.0) < 0.000001
+	} else {
+		assert false
+	}
+}
+
+fn test_numeric_step_result_modifiers() {
+	cfg := NumericStepCfg{
+		step:             1.0
+		shift_multiplier: 10.0
+		alt_multiplier:   0.1
+	}
+	value_shift, text_shift := numeric_input_step_result('5', none, none, none, 2, cfg,
+		NumericLocaleCfg{}, 1.0, .shift)
+	assert text_shift == '15.00'
+	if parsed := value_shift {
+		assert math.abs(parsed - 15.0) < 0.000001
+	} else {
+		assert false
+	}
+
+	value_alt, text_alt := numeric_input_step_result('5', none, none, none, 2, cfg, NumericLocaleCfg{},
+		1.0, .alt)
+	assert text_alt == '5.10'
+	if parsed := value_alt {
+		assert math.abs(parsed - 5.1) < 0.000001
+	} else {
+		assert false
+	}
+}

docs/DATA_GRID_PLAN.md

@@ -277,6 +277,43 @@ gui.input(
 )
 ```
 
+## Numeric Input
+
+`gui.numeric_input` provides locale-aware numeric parsing/formatting and step controls.
+
+Fields:
+- `value ?f64`
+- `locale NumericLocaleCfg`
+- `step_cfg NumericStepCfg`
+- `decimals int`
+- `min ?f64` / `max ?f64`
+- `on_value_commit fn (&Layout, ?f64, string, mut Window)`
+
+Rules:
+- raw text can be temporarily invalid while editing
+- commit (`enter` / blur / step) parses, clamps, formats, emits `on_value_commit`
+- step controls support buttons, mouse wheel, and `up/down` keys
+- `shift` multiplies step by `10`, `alt` multiplies step by `0.1`
+
+```v ignore
+gui.numeric_input(
+	id_focus:  1
+	text:      app.amount_text
+	value:     app.amount_value
+	decimals:  2
+	min:       0.0
+	max:       10000.0
+	on_text_changed: fn (_ &gui.Layout, text string, mut w gui.Window) {
+		w.state[App]().amount_text = text
+	}
+	on_value_commit: fn (_ &gui.Layout, value ?f64, text string, mut w gui.Window) {
+		mut app := w.state[App]()
+		app.amount_value = value
+		app.amount_text = text
+	}
+)
+```
+
 ## Why v-gui Feels Different
 
 **No widget objects to manage.** Traditional frameworks make you create button objects, store
@@ -309,6 +346,7 @@ v run examples/animations.v     # Tweens, springs, hero transitions
 v run examples/svg_demo.v       # Vector icon rendering
 v run examples/tiger.v          # Complex SVG (Ghostscript Tiger)
 v run examples/markdown.v       # Markdown rendering
+v run examples/numeric_input.v  # Locale-aware numeric input + stepping
 v run examples/dialogs.v        # Custom + native dialogs
 v run examples/text_transform.v # Rotated and affine text
 v run examples/table_demo.v     # Table widget demo

docs/GET_STARTED.md

@@ -19,9 +19,9 @@ This file is a forward-only todo list for professional-grade `v-gui`.
 
 ### Input + Forms
 
-- [ ] Input masking engine (`9`, `a`, `*`, literals, escaped tokens, custom tokens)
+- [x] Input masking engine (`9`, `a`, `*`, literals, escaped tokens, custom tokens)
 - [x] Ready masks: phone, date, time, credit card, postal, SSN
-- [ ] Numeric input view with locale-aware parse/format and step controls
+- [x] Numeric input view with locale-aware parse/format and step controls
 - [ ] Currency/percent input modes with round-trip-safe formatting
 - [ ] Form validation model: sync/async validators, touched/dirty state, error slots
 - [ ] Unified input formatter pipeline (pre-commit transform + post-commit normalize)

docs/ROADMAP.md

@@ -0,0 +1,100 @@
+import gui
+
+@[heap]
+struct NumericInputApp {
+mut:
+	en_text  string = '1,234.50'
+	en_value ?f64   = 1234.5
+	de_text  string = '1.234,50'
+	de_value ?f64   = 1234.5
+}
+
+fn main() {
+	mut window := gui.window(
+		title:   'Numeric Input'
+		state:   &NumericInputApp{}
+		width:   300
+		height:  280
+		on_init: fn (mut w gui.Window) {
+			w.update_view(main_view)
+			w.set_id_focus(1)
+		}
+	)
+	window.set_theme(gui.theme_dark_bordered)
+	window.run()
+}
+
+fn main_view(window &gui.Window) gui.View {
+	w, h := window.window_size()
+	app := window.state[NumericInputApp]()
+	return gui.column(
+		width:   w
+		height:  h
+		sizing:  gui.fixed_fixed
+		padding: gui.padding_medium
+		spacing: gui.spacing_medium
+		content: [
+			gui.text(text: 'Locale: en_US'),
+			gui.numeric_input(
+				id:                 'num_en'
+				id_focus:           1
+				text:               app.en_text
+				value:              app.en_value
+				decimals:           2
+				min:                0.0
+				max:                10000.0
+				size_border:        1.5
+				color_border:       gui.rgb(160, 160, 160)
+				color_border_focus: gui.rgb(81, 165, 255)
+				padding:            gui.padding_two_four
+				width:              220
+				sizing:             gui.fixed_fit
+				on_text_changed:    fn (_ &gui.Layout, text string, mut w gui.Window) {
+					mut state := w.state[NumericInputApp]()
+					state.en_text = text
+				}
+				on_value_commit:    fn (_ &gui.Layout, value ?f64, text string, mut w gui.Window) {
+					mut state := w.state[NumericInputApp]()
+					state.en_value = value
+					state.en_text = text
+				}
+			),
+			gui.text(text: 'Committed value: ${numeric_value_text(app.en_value)}'),
+			gui.text(text: 'Locale: de_DE'),
+			gui.numeric_input(
+				id:                 'num_de'
+				id_focus:           2
+				text:               app.de_text
+				value:              app.de_value
+				decimals:           2
+				locale:             gui.NumericLocaleCfg{
+					decimal_sep: `,`
+					group_sep:   `.`
+				}
+				size_border:        1.5
+				color_border:       gui.rgb(160, 160, 160)
+				color_border_focus: gui.rgb(81, 165, 255)
+				padding:            gui.padding_two_four
+				width:              220
+				sizing:             gui.fixed_fit
+				on_text_changed:    fn (_ &gui.Layout, text string, mut w gui.Window) {
+					mut state := w.state[NumericInputApp]()
+					state.de_text = text
+				}
+				on_value_commit:    fn (_ &gui.Layout, value ?f64, text string, mut w gui.Window) {
+					mut state := w.state[NumericInputApp]()
+					state.de_value = value
+					state.de_text = text
+				}
+			),
+			gui.text(text: 'Committed value: ${numeric_value_text(app.de_value)}'),
+		]
+	)
+}
+
+fn numeric_value_text(value ?f64) string {
+	if parsed := value {
+		return '${parsed:.2f}'
+	}
+	return 'none'
+}