TheriapolisV3

Howlwind/TheriapolisV3

Fork 0

Commit Graph

Author	SHA1	Message	Date
Christopher Wiebe	ee5439285c	M6.1: Character creation wizard foundation (.tscn + Resource-based draft) Pivots from M5's code-built UI to the editor-authorable .tscn pattern recommended in GODOT_PORTING_GUIDE.md, after a session of fighting Godot idioms with code-only layout. Default theme only; the parchment Theme lands last per the guide's §12 build order so layout bugs surface as layout bugs, not theming bugs. GODOT_PORTING_GUIDE.md: Authored by Claude Design as the canonical port reference. Maps the React prototype's structure onto Godot 4.6 with concrete code sketches and a build-order recommendation. Drove the M6 architecture. Fonts/: Cormorant Garamond (Medium + MediumItalic) and Crimson Pro (Regular + Italic + SemiBold) under OFL — the React prototype's serif-display and serif-body families. Not yet wired through CodexTheme.Build() because theming is deferred; CodexTheme.LoadFontFromFonts already picks them up automatically when the Theme pass lands. Scenes/Wizard.tscn + Wizard.cs: Wizard shell per guide §4: codex-header (title + folio counter) + Stepper + Page (StepHost + Aside) + NavBar (Back / validation / Next). All node lookups via unique-name (%) syntax; layout authored as a scene file you can open in the editor. Step lifecycle drives the Aside via signal binding. Stepper logic mirrors app.jsx — locked iff some EARLIER step is unsatisfied; "type not yet implemented" doesn't lock. Scenes/Aside.tscn + Aside.cs: Right-rail summary per guide §10. Single Refresh() rebuild on CharacterDraft.Changed; cheap enough not to bother with partial updates. Width 320 (was 380 before the layout overflow fix). Scenes/Steps/IStep.cs + StepClade.cs: Per-step Bind(draft) + Validate() contract. StepClade renders the 3-column clade card grid; click commits via CharacterDraft.Patch which triggers the Resource.Changed signal that Aside and Wizard both subscribe to. UI/CharacterDraft.cs: Resource (not Node) per guide §2.1. Mirrors app.jsx's `state` shape exactly. Patch(dictionary) emits the inherited Resource.Changed signal — listeners use `draft.Changed += handler` regardless of which field changed. CodexContent provides lazy-loaded immutable content tables (Clades, Species, Classes, Subclasses, Backgrounds). Main.{cs,tscn}: Node → Control When Main was a Node, Control children couldn't anchor to a real parent rect — they sat at (0,0) at intrinsic min size. With wide step content (3-column 200-px-card grid), the Wizard's min size pushed the navbar beyond the viewport's right edge, hiding the Next button on smaller windowed viewports. Making Main a full-rect- anchored Control gives child scenes a proper rect to lay out in. UI/Widgets/CodexStepper.cs: Anchored the inner vbox to fill the button rect. Without this, the vbox sat at the button's top-left at intrinsic size and labels rendered in the corner — visible as the active-step label being off-center from the highlight bar. Verified at 1152x720 windowed and (separately) at fullscreen: - 3-column card grid fits inside Wrap margins + Aside without horizontal overflow - Stepper labels centered under their highlight bars - Next button visible after clade selection; future steps switch to "coming soon" placeholder when clicked - Aside summary fills in CLADE block on selection Closes M6.1. Next per guide §12 build order: M6.2 — StepStats with drag-drop (highest-risk piece, de-risk before easy steps). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>	2026-05-02 19:35:03 -07:00
Christopher Wiebe	953bb985ad	M5: Codex design system (dark theme) + kitchen-sink Programmatic Theme builder + reusable popover and stepper widgets, ported from CharacterCreator.zip's :root design tokens. Kitchen-sink scene exercises every primitive for visual eyeballing. CodexPalette.cs: Color tokens lifted verbatim from the React prototype's `:root` block (--bg, --ink, --gild, --seal, etc.). Variable names mirror the CSS so the audit trail stays readable. Spacing locked at the prototype's normal density (--gap=24, --pad=28, --radius=2). Scope cut: only the Dark theme ships. The React prototype designed Parchment, Dark, and Blood as switchable variations — user direction during M5 is that only Dark (leather + candlelight) is wanted for this game. Parchment/Blood code dropped, plan doc updated to match (§1 goal #5, §4.5 UI map, §5 M5 scope, §10 resolved decisions #4). No runtime theme switcher. CodexTheme.Build(): Programmatically constructs a Godot Theme from CodexPalette.Dark plus CodexSpacing/CodexType tokens. Configures Panel, Card, CodexPopover styleboxes; Label variations for H1..H4, CodexTitle, Eyebrow, Meta, ValidationOk/Error, CardName/Body/Meta, StepperNum/ Name; Button + PrimaryButton + GhostButton variants; LineEdit, CheckBox, scrollbar styling. Fonts: looks for CormorantGaramond / CrimsonPro / JetBrainsMono TTFs in res://Fonts/ (or Content/Fonts/) and graceful-falls-back to Godot defaults if missing. M5 ships with no fonts in repo; user can drop them in later for typography parity with the React prototype. CodexPopover.cs: Hoverable text trigger + floating PanelContainer, mirrors src/trait-hint.jsx. Viewport-clamps horizontally and vertically; flips above the trigger if there's no room below; 80 ms grace period when moving cursor from trigger to popover. Detriment variant uses the seal-coloured stylebox. Future TraitName / SkillChip / BonusPill widgets layer className differences on top. CodexStepper.cs: Roman-numeral horizontal stepper with Pending / Active / Complete / Locked states. Active step gets a 2-px gild underline, Complete shows a ✓ in seal-red, Locked shows ✕ + 0.45 modulate. Emits StepClicked(int) for non-locked rows. M5 is decorative — M6 wires the signal to the character-creation state machine. KitchenSink.cs + Main.cs --codex-test: Verification scene rendering every primitive (header, stepper, buttons, inputs, cards, trait popovers). Clicks log to console. Fonts default to Godot's Noto Sans until res://Fonts/ is populated. Closes M5 of theriapolis-rpg-implementation-plan-godot-port.md. Next: M6 (title + character creation). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>	2026-05-01 20:29:22 -07:00

Author

SHA1

Message

Date

Christopher Wiebe

ee5439285c

M6.1: Character creation wizard foundation (.tscn + Resource-based draft)

Pivots from M5's code-built UI to the editor-authorable .tscn pattern
recommended in GODOT_PORTING_GUIDE.md, after a session of fighting
Godot idioms with code-only layout. Default theme only; the parchment
Theme lands last per the guide's §12 build order so layout bugs surface
as layout bugs, not theming bugs.

GODOT_PORTING_GUIDE.md:
  Authored by Claude Design as the canonical port reference. Maps the
  React prototype's structure onto Godot 4.6 with concrete code sketches
  and a build-order recommendation. Drove the M6 architecture.

Fonts/:
  Cormorant Garamond (Medium + MediumItalic) and Crimson Pro (Regular +
  Italic + SemiBold) under OFL — the React prototype's serif-display
  and serif-body families. Not yet wired through CodexTheme.Build()
  because theming is deferred; CodexTheme.LoadFontFromFonts already
  picks them up automatically when the Theme pass lands.

Scenes/Wizard.tscn + Wizard.cs:
  Wizard shell per guide §4: codex-header (title + folio counter) +
  Stepper + Page (StepHost + Aside) + NavBar (Back / validation / Next).
  All node lookups via unique-name (%) syntax; layout authored as a
  scene file you can open in the editor. Step lifecycle drives the
  Aside via signal binding. Stepper logic mirrors app.jsx — locked
  iff some EARLIER step is unsatisfied; "type not yet implemented"
  doesn't lock.

Scenes/Aside.tscn + Aside.cs:
  Right-rail summary per guide §10. Single Refresh() rebuild on
  CharacterDraft.Changed; cheap enough not to bother with partial
  updates. Width 320 (was 380 before the layout overflow fix).

Scenes/Steps/IStep.cs + StepClade.cs:
  Per-step Bind(draft) + Validate() contract. StepClade renders the
  3-column clade card grid; click commits via CharacterDraft.Patch
  which triggers the Resource.Changed signal that Aside and Wizard
  both subscribe to.

UI/CharacterDraft.cs:
  Resource (not Node) per guide §2.1. Mirrors app.jsx's `state` shape
  exactly. Patch(dictionary) emits the inherited Resource.Changed
  signal — listeners use `draft.Changed += handler` regardless of
  which field changed. CodexContent provides lazy-loaded immutable
  content tables (Clades, Species, Classes, Subclasses, Backgrounds).

Main.{cs,tscn}: Node → Control
  When Main was a Node, Control children couldn't anchor to a real
  parent rect — they sat at (0,0) at intrinsic min size. With wide
  step content (3-column 200-px-card grid), the Wizard's min size
  pushed the navbar beyond the viewport's right edge, hiding the Next
  button on smaller windowed viewports. Making Main a full-rect-
  anchored Control gives child scenes a proper rect to lay out in.

UI/Widgets/CodexStepper.cs:
  Anchored the inner vbox to fill the button rect. Without this, the
  vbox sat at the button's top-left at intrinsic size and labels
  rendered in the corner — visible as the active-step label being
  off-center from the highlight bar.

Verified at 1152x720 windowed and (separately) at fullscreen:
  - 3-column card grid fits inside Wrap margins + Aside without
    horizontal overflow
  - Stepper labels centered under their highlight bars
  - Next button visible after clade selection; future steps switch
    to "coming soon" placeholder when clicked
  - Aside summary fills in CLADE block on selection

Closes M6.1.  Next per guide §12 build order: M6.2 — StepStats with
drag-drop (highest-risk piece, de-risk before easy steps).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-05-02 19:35:03 -07:00

Christopher Wiebe

953bb985ad

M5: Codex design system (dark theme) + kitchen-sink

Programmatic Theme builder + reusable popover and stepper widgets,
ported from CharacterCreator.zip's :root design tokens. Kitchen-sink
scene exercises every primitive for visual eyeballing.

CodexPalette.cs:
  Color tokens lifted verbatim from the React prototype's `:root`
  block (--bg, --ink, --gild, --seal, etc.). Variable names mirror
  the CSS so the audit trail stays readable. Spacing locked at the
  prototype's normal density (--gap=24, --pad=28, --radius=2).

  Scope cut: only the Dark theme ships. The React prototype designed
  Parchment, Dark, and Blood as switchable variations — user direction
  during M5 is that only Dark (leather + candlelight) is wanted for
  this game. Parchment/Blood code dropped, plan doc updated to match
  (§1 goal #5, §4.5 UI map, §5 M5 scope, §10 resolved decisions #4).
  No runtime theme switcher.

CodexTheme.Build():
  Programmatically constructs a Godot Theme from CodexPalette.Dark
  plus CodexSpacing/CodexType tokens. Configures Panel, Card,
  CodexPopover styleboxes; Label variations for H1..H4, CodexTitle,
  Eyebrow, Meta, ValidationOk/Error, CardName/Body/Meta, StepperNum/
  Name; Button + PrimaryButton + GhostButton variants; LineEdit,
  CheckBox, scrollbar styling.

  Fonts: looks for CormorantGaramond / CrimsonPro / JetBrainsMono
  TTFs in res://Fonts/ (or Content/Fonts/) and graceful-falls-back to
  Godot defaults if missing. M5 ships with no fonts in repo; user can
  drop them in later for typography parity with the React prototype.

CodexPopover.cs:
  Hoverable text trigger + floating PanelContainer, mirrors
  src/trait-hint.jsx. Viewport-clamps horizontally and vertically;
  flips above the trigger if there's no room below; 80 ms grace
  period when moving cursor from trigger to popover. Detriment
  variant uses the seal-coloured stylebox. Future TraitName /
  SkillChip / BonusPill widgets layer className differences on top.

CodexStepper.cs:
  Roman-numeral horizontal stepper with Pending / Active / Complete /
  Locked states. Active step gets a 2-px gild underline, Complete
  shows a ✓ in seal-red, Locked shows ✕ + 0.45 modulate. Emits
  StepClicked(int) for non-locked rows. M5 is decorative — M6 wires
  the signal to the character-creation state machine.

KitchenSink.cs + Main.cs --codex-test:
  Verification scene rendering every primitive (header, stepper,
  buttons, inputs, cards, trait popovers). Clicks log to console.
  Fonts default to Godot's Noto Sans until res://Fonts/ is populated.

Closes M5 of theriapolis-rpg-implementation-plan-godot-port.md.
Next: M6 (title + character creation).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

2026-05-01 20:29:22 -07:00

2 Commits