fix(graph-3d): family-distinct node colors + larger course roots - #95

Merged
Jose-Gael-Cruz-Lopez merged 5 commits into
feat/knowledge-graph-3dfrom
fix/graph-family-colors
May 6, 2026
Merged

fix(graph-3d): family-distinct node colors + larger course roots#95
Jose-Gael-Cruz-Lopez merged 5 commits into
feat/knowledge-graph-3dfrom
fix/graph-family-colors

Conversation

@Jose-Gael-Cruz-Lopez

Copy link
Copy Markdown
Member

Summary

  • Three.js was rendering every node black because shadeFor returned space-separated hsl(120 50% 50%) strings, which Color.setStyle only accepts comma-separated. Switched shadeFor to hex output via a new hslToHex helper.
  • Added paletteFor (in lib/data.ts) — a deterministic 8-color brand palette indexed by course_id. So when the backend doesn't supply a per-course color, each family still gets its own distinct hue instead of every concept collapsing onto one fallback.
  • Tightened hue variance on the per-node shading (±25 → ±10) so every child of a course reads as a clear shade of that family's color rather than drifting into a sibling's hue.
  • Course-root nodes pinned to a fixed larger nodeVal (22) so the family center anchors the eye.
  • Replaced var(--c-sage) fallbacks in Tree.tsx/Learn.tsx/Dashboard.tsx with paletteFor(course_id || subject). CSS custom properties don't survive WebGL — that fallback was contributing to all-black rendering.

Stacked on top of #92 — base = feat/knowledge-graph-3d. After #92 merges, this PR's base will auto-update to main.

Test plan

  • npx vitest run — 8/8 KnowledgeGraph component tests pass; updated test pins hex output (was pinning hsl(...)) and the new course-root sizing.
  • npx tsc --noEmit — clean.
  • npm run check:lockfile — green.
  • Visual smoke test: open /learn, /tree, /dashboard — confirm each course family is visibly distinct and root nodes are noticeably larger.

🤖 Generated with Claude Code

Three.js's Color.setStyle silently rendered every node black because
shadeFor returned space-separated `hsl(120 50% 50%)` strings, which
the parser only accepts comma-separated. Switch shadeFor to hex
output, tighten hue variance ±25 → ±10 so each course family reads
as one cohesive color band, and add a deterministic palette fallback
(paletteFor in lib/data.ts) so backends without course_color still
get distinct hues per course_id. Course-root nodes pinned to a
larger fixed size (nodeVal=22) so the family center anchors the eye.
Replace var(--c-sage) screen fallbacks with resolved hex — CSS
custom properties don't survive WebGL.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitaiBot commented May 5, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 91cec15f-8c05-434c-8d8b-450d06bd293c

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/graph-family-colors

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Two fixes from PR #95 review:
1. The palette seed in apiToGraphNode preferred n.course_id over
course?.course_id. When some nodes in a family carry course_id
and others don't (falling through to subject), they hashed to
different palette colors and the family visually split. Prefer
the course-record id so all nodes in a family seed identically.
2. shadeFor used `hexToHsl(FALLBACK)!` — safe today only because
the FALLBACK constant happens to parse. Replaced with a
precomputed FALLBACK_HSL literal (`{h: 75, s: 26, l: 48}` =
#8a9a5b) so the call site can never silently break.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pagesBot commented May 5, 2026

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
frontende177171Commit Preview URL

Branch Preview URL
May 06 2026, 02:14 AM

Jose-Gael-Cruz-Lopezand others added 3 commits May 5, 2026 21:55
Three non-blocking follow-ups from PR #95 review:
1. Deduplicate the DJB2 hash (was reimplemented in lib/data.ts and
KnowledgeGraph.tsx) into a single `hashSeed` export.
2. Hoist the triplicated apiToGraphNode adapter from Tree/Learn/
Dashboard into lib/data.ts.
3. Add unit tests for paletteFor + hashSeed.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
WCAG audit against the cream `--bg` (#faf8f3) flagged two palette
entries below the 3:1 non-text-UI threshold:
- sage #8a9a5b → 2.89:1 → #7a874f (~3.5:1)
- ochre #c89c4a → 2.38:1 → #a87d2e (~3.6:1)
Both nudged darker along the same hue band so node circles stay
legible on the light theme. Brand --accent (#8a9a5b) is unchanged
elsewhere — this palette is only the backend-color fallback.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Locks down the round-2 fix: when n.course_id and course.course_id
disagree, the palette seed must come from the course record so every
node in the same family hashes to the same color. Also pins the
two simpler fallback branches and the subject_root → mastered
tier remap.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@Jose-Gael-Cruz-Lopez
Jose-Gael-Cruz-Lopez merged commit b1440d8 into feat/knowledge-graph-3dMay 6, 2026
2 checks passed
@AndresL230
AndresL230 deleted the fix/graph-family-colors branch June 27, 2026 04:21
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@Jose-Gael-Cruz-Lopez
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

fix(graph-3d): family-distinct node colors + larger course roots - #95

Merged
Jose-Gael-Cruz-Lopez merged 5 commits into
feat/knowledge-graph-3dfrom
fix/graph-family-colors
May 6, 2026
Merged

fix(graph-3d): family-distinct node colors + larger course roots#95
Jose-Gael-Cruz-Lopez merged 5 commits into
feat/knowledge-graph-3dfrom
fix/graph-family-colors

Conversation

@Jose-Gael-Cruz-Lopez

Copy link
Copy Markdown
Member

Summary

  • Three.js was rendering every node black because shadeFor returned space-separated hsl(120 50% 50%) strings, which Color.setStyle only accepts comma-separated. Switched shadeFor to hex output via a new hslToHex helper.
  • Added paletteFor (in lib/data.ts) — a deterministic 8-color brand palette indexed by course_id. So when the backend doesn't supply a per-course color, each family still gets its own distinct hue instead of every concept collapsing onto one fallback.
  • Tightened hue variance on the per-node shading (±25 → ±10) so every child of a course reads as a clear shade of that family's color rather than drifting into a sibling's hue.
  • Course-root nodes pinned to a fixed larger nodeVal (22) so the family center anchors the eye.
  • Replaced var(--c-sage) fallbacks in Tree.tsx/Learn.tsx/Dashboard.tsx with paletteFor(course_id || subject). CSS custom properties don't survive WebGL — that fallback was contributing to all-black rendering.

Stacked on top of #92 — base = feat/knowledge-graph-3d. After #92 merges, this PR's base will auto-update to main.

Test plan

  • npx vitest run — 8/8 KnowledgeGraph component tests pass; updated test pins hex output (was pinning hsl(...)) and the new course-root sizing.
  • npx tsc --noEmit — clean.
  • npm run check:lockfile — green.
  • Visual smoke test: open /learn, /tree, /dashboard — confirm each course family is visibly distinct and root nodes are noticeably larger.

🤖 Generated with Claude Code

Three.js's Color.setStyle silently rendered every node black because
shadeFor returned space-separated `hsl(120 50% 50%)` strings, which
the parser only accepts comma-separated. Switch shadeFor to hex
output, tighten hue variance ±25 → ±10 so each course family reads
as one cohesive color band, and add a deterministic palette fallback
(paletteFor in lib/data.ts) so backends without course_color still
get distinct hues per course_id. Course-root nodes pinned to a
larger fixed size (nodeVal=22) so the family center anchors the eye.
Replace var(--c-sage) screen fallbacks with resolved hex — CSS
custom properties don't survive WebGL.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitaiBot commented May 5, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 91cec15f-8c05-434c-8d8b-450d06bd293c

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/graph-family-colors

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Two fixes from PR #95 review:
1. The palette seed in apiToGraphNode preferred n.course_id over
course?.course_id. When some nodes in a family carry course_id
and others don't (falling through to subject), they hashed to
different palette colors and the family visually split. Prefer
the course-record id so all nodes in a family seed identically.
2. shadeFor used `hexToHsl(FALLBACK)!` — safe today only because
the FALLBACK constant happens to parse. Replaced with a
precomputed FALLBACK_HSL literal (`{h: 75, s: 26, l: 48}` =
#8a9a5b) so the call site can never silently break.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pagesBot commented May 5, 2026

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
frontende177171Commit Preview URL

Branch Preview URL
May 06 2026, 02:14 AM

Jose-Gael-Cruz-Lopezand others added 3 commits May 5, 2026 21:55
Three non-blocking follow-ups from PR #95 review:
1. Deduplicate the DJB2 hash (was reimplemented in lib/data.ts and
KnowledgeGraph.tsx) into a single `hashSeed` export.
2. Hoist the triplicated apiToGraphNode adapter from Tree/Learn/
Dashboard into lib/data.ts.
3. Add unit tests for paletteFor + hashSeed.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
WCAG audit against the cream `--bg` (#faf8f3) flagged two palette
entries below the 3:1 non-text-UI threshold:
- sage #8a9a5b → 2.89:1 → #7a874f (~3.5:1)
- ochre #c89c4a → 2.38:1 → #a87d2e (~3.6:1)
Both nudged darker along the same hue band so node circles stay
legible on the light theme. Brand --accent (#8a9a5b) is unchanged
elsewhere — this palette is only the backend-color fallback.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Locks down the round-2 fix: when n.course_id and course.course_id
disagree, the palette seed must come from the course record so every
node in the same family hashes to the same color. Also pins the
two simpler fallback branches and the subject_root → mastered
tier remap.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@Jose-Gael-Cruz-Lopez
Jose-Gael-Cruz-Lopez merged commit b1440d8 into feat/knowledge-graph-3dMay 6, 2026
2 checks passed
@AndresL230
AndresL230 deleted the fix/graph-family-colors branch June 27, 2026 04:21
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@Jose-Gael-Cruz-Lopez
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(graph-3d): family-distinct node colors + larger course roots - #95

Merged
Jose-Gael-Cruz-Lopez merged 5 commits into
feat/knowledge-graph-3dfrom
fix/graph-family-colors
May 6, 2026
Merged

fix(graph-3d): family-distinct node colors + larger course roots#95
Jose-Gael-Cruz-Lopez merged 5 commits into
feat/knowledge-graph-3dfrom
fix/graph-family-colors

Conversation

@Jose-Gael-Cruz-Lopez

Copy link
Copy Markdown
Member

Summary

  • Three.js was rendering every node black because shadeFor returned space-separated hsl(120 50% 50%) strings, which Color.setStyle only accepts comma-separated. Switched shadeFor to hex output via a new hslToHex helper.
  • Added paletteFor (in lib/data.ts) — a deterministic 8-color brand palette indexed by course_id. So when the backend doesn't supply a per-course color, each family still gets its own distinct hue instead of every concept collapsing onto one fallback.
  • Tightened hue variance on the per-node shading (±25 → ±10) so every child of a course reads as a clear shade of that family's color rather than drifting into a sibling's hue.
  • Course-root nodes pinned to a fixed larger nodeVal (22) so the family center anchors the eye.
  • Replaced var(--c-sage) fallbacks in Tree.tsx/Learn.tsx/Dashboard.tsx with paletteFor(course_id || subject). CSS custom properties don't survive WebGL — that fallback was contributing to all-black rendering.

Stacked on top of #92 — base = feat/knowledge-graph-3d. After #92 merges, this PR's base will auto-update to main.

Test plan

  • npx vitest run — 8/8 KnowledgeGraph component tests pass; updated test pins hex output (was pinning hsl(...)) and the new course-root sizing.
  • npx tsc --noEmit — clean.
  • npm run check:lockfile — green.
  • Visual smoke test: open /learn, /tree, /dashboard — confirm each course family is visibly distinct and root nodes are noticeably larger.

🤖 Generated with Claude Code

Three.js's Color.setStyle silently rendered every node black because
shadeFor returned space-separated `hsl(120 50% 50%)` strings, which
the parser only accepts comma-separated. Switch shadeFor to hex
output, tighten hue variance ±25 → ±10 so each course family reads
as one cohesive color band, and add a deterministic palette fallback
(paletteFor in lib/data.ts) so backends without course_color still
get distinct hues per course_id. Course-root nodes pinned to a
larger fixed size (nodeVal=22) so the family center anchors the eye.
Replace var(--c-sage) screen fallbacks with resolved hex — CSS
custom properties don't survive WebGL.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitaiBot commented May 5, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 91cec15f-8c05-434c-8d8b-450d06bd293c

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/graph-family-colors

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Two fixes from PR #95 review:
1. The palette seed in apiToGraphNode preferred n.course_id over
course?.course_id. When some nodes in a family carry course_id
and others don't (falling through to subject), they hashed to
different palette colors and the family visually split. Prefer
the course-record id so all nodes in a family seed identically.
2. shadeFor used `hexToHsl(FALLBACK)!` — safe today only because
the FALLBACK constant happens to parse. Replaced with a
precomputed FALLBACK_HSL literal (`{h: 75, s: 26, l: 48}` =
#8a9a5b) so the call site can never silently break.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pagesBot commented May 5, 2026

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
frontende177171Commit Preview URL

Branch Preview URL
May 06 2026, 02:14 AM

Jose-Gael-Cruz-Lopezand others added 3 commits May 5, 2026 21:55
Three non-blocking follow-ups from PR #95 review:
1. Deduplicate the DJB2 hash (was reimplemented in lib/data.ts and
KnowledgeGraph.tsx) into a single `hashSeed` export.
2. Hoist the triplicated apiToGraphNode adapter from Tree/Learn/
Dashboard into lib/data.ts.
3. Add unit tests for paletteFor + hashSeed.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
WCAG audit against the cream `--bg` (#faf8f3) flagged two palette
entries below the 3:1 non-text-UI threshold:
- sage #8a9a5b → 2.89:1 → #7a874f (~3.5:1)
- ochre #c89c4a → 2.38:1 → #a87d2e (~3.6:1)
Both nudged darker along the same hue band so node circles stay
legible on the light theme. Brand --accent (#8a9a5b) is unchanged
elsewhere — this palette is only the backend-color fallback.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Locks down the round-2 fix: when n.course_id and course.course_id
disagree, the palette seed must come from the course record so every
node in the same family hashes to the same color. Also pins the
two simpler fallback branches and the subject_root → mastered
tier remap.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@Jose-Gael-Cruz-Lopez
Jose-Gael-Cruz-Lopez merged commit b1440d8 into feat/knowledge-graph-3dMay 6, 2026
2 checks passed
@AndresL230
AndresL230 deleted the fix/graph-family-colors branch June 27, 2026 04:21
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@Jose-Gael-Cruz-Lopez
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(graph-3d): family-distinct node colors + larger course roots - #95

Merged
Jose-Gael-Cruz-Lopez merged 5 commits into
feat/knowledge-graph-3dfrom
fix/graph-family-colors
May 6, 2026
Merged

fix(graph-3d): family-distinct node colors + larger course roots#95
Jose-Gael-Cruz-Lopez merged 5 commits into
feat/knowledge-graph-3dfrom
fix/graph-family-colors

Conversation

@Jose-Gael-Cruz-Lopez

Copy link
Copy Markdown
Member

Summary

  • Three.js was rendering every node black because shadeFor returned space-separated hsl(120 50% 50%) strings, which Color.setStyle only accepts comma-separated. Switched shadeFor to hex output via a new hslToHex helper.
  • Added paletteFor (in lib/data.ts) — a deterministic 8-color brand palette indexed by course_id. So when the backend doesn't supply a per-course color, each family still gets its own distinct hue instead of every concept collapsing onto one fallback.
  • Tightened hue variance on the per-node shading (±25 → ±10) so every child of a course reads as a clear shade of that family's color rather than drifting into a sibling's hue.
  • Course-root nodes pinned to a fixed larger nodeVal (22) so the family center anchors the eye.
  • Replaced var(--c-sage) fallbacks in Tree.tsx/Learn.tsx/Dashboard.tsx with paletteFor(course_id || subject). CSS custom properties don't survive WebGL — that fallback was contributing to all-black rendering.

Stacked on top of #92 — base = feat/knowledge-graph-3d. After #92 merges, this PR's base will auto-update to main.

Test plan

  • npx vitest run — 8/8 KnowledgeGraph component tests pass; updated test pins hex output (was pinning hsl(...)) and the new course-root sizing.
  • npx tsc --noEmit — clean.
  • npm run check:lockfile — green.
  • Visual smoke test: open /learn, /tree, /dashboard — confirm each course family is visibly distinct and root nodes are noticeably larger.

🤖 Generated with Claude Code

Three.js's Color.setStyle silently rendered every node black because
shadeFor returned space-separated `hsl(120 50% 50%)` strings, which
the parser only accepts comma-separated. Switch shadeFor to hex
output, tighten hue variance ±25 → ±10 so each course family reads
as one cohesive color band, and add a deterministic palette fallback
(paletteFor in lib/data.ts) so backends without course_color still
get distinct hues per course_id. Course-root nodes pinned to a
larger fixed size (nodeVal=22) so the family center anchors the eye.
Replace var(--c-sage) screen fallbacks with resolved hex — CSS
custom properties don't survive WebGL.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitaiBot commented May 5, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 91cec15f-8c05-434c-8d8b-450d06bd293c

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/graph-family-colors

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Two fixes from PR #95 review:
1. The palette seed in apiToGraphNode preferred n.course_id over
course?.course_id. When some nodes in a family carry course_id
and others don't (falling through to subject), they hashed to
different palette colors and the family visually split. Prefer
the course-record id so all nodes in a family seed identically.
2. shadeFor used `hexToHsl(FALLBACK)!` — safe today only because
the FALLBACK constant happens to parse. Replaced with a
precomputed FALLBACK_HSL literal (`{h: 75, s: 26, l: 48}` =
#8a9a5b) so the call site can never silently break.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pagesBot commented May 5, 2026

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
frontende177171Commit Preview URL

Branch Preview URL
May 06 2026, 02:14 AM

Jose-Gael-Cruz-Lopezand others added 3 commits May 5, 2026 21:55
Three non-blocking follow-ups from PR #95 review:
1. Deduplicate the DJB2 hash (was reimplemented in lib/data.ts and
KnowledgeGraph.tsx) into a single `hashSeed` export.
2. Hoist the triplicated apiToGraphNode adapter from Tree/Learn/
Dashboard into lib/data.ts.
3. Add unit tests for paletteFor + hashSeed.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
WCAG audit against the cream `--bg` (#faf8f3) flagged two palette
entries below the 3:1 non-text-UI threshold:
- sage #8a9a5b → 2.89:1 → #7a874f (~3.5:1)
- ochre #c89c4a → 2.38:1 → #a87d2e (~3.6:1)
Both nudged darker along the same hue band so node circles stay
legible on the light theme. Brand --accent (#8a9a5b) is unchanged
elsewhere — this palette is only the backend-color fallback.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Locks down the round-2 fix: when n.course_id and course.course_id
disagree, the palette seed must come from the course record so every
node in the same family hashes to the same color. Also pins the
two simpler fallback branches and the subject_root → mastered
tier remap.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@Jose-Gael-Cruz-Lopez
Jose-Gael-Cruz-Lopez merged commit b1440d8 into feat/knowledge-graph-3dMay 6, 2026
2 checks passed
@AndresL230
AndresL230 deleted the fix/graph-family-colors branch June 27, 2026 04:21
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@Jose-Gael-Cruz-Lopez
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

fix(graph-3d): family-distinct node colors + larger course roots - #95

Merged
Jose-Gael-Cruz-Lopez merged 5 commits into
feat/knowledge-graph-3dfrom
fix/graph-family-colors
May 6, 2026
Merged

fix(graph-3d): family-distinct node colors + larger course roots#95
Jose-Gael-Cruz-Lopez merged 5 commits into
feat/knowledge-graph-3dfrom
fix/graph-family-colors

Conversation

@Jose-Gael-Cruz-Lopez

Copy link
Copy Markdown
Member

Summary

  • Three.js was rendering every node black because shadeFor returned space-separated hsl(120 50% 50%) strings, which Color.setStyle only accepts comma-separated. Switched shadeFor to hex output via a new hslToHex helper.
  • Added paletteFor (in lib/data.ts) — a deterministic 8-color brand palette indexed by course_id. So when the backend doesn't supply a per-course color, each family still gets its own distinct hue instead of every concept collapsing onto one fallback.
  • Tightened hue variance on the per-node shading (±25 → ±10) so every child of a course reads as a clear shade of that family's color rather than drifting into a sibling's hue.
  • Course-root nodes pinned to a fixed larger nodeVal (22) so the family center anchors the eye.
  • Replaced var(--c-sage) fallbacks in Tree.tsx/Learn.tsx/Dashboard.tsx with paletteFor(course_id || subject). CSS custom properties don't survive WebGL — that fallback was contributing to all-black rendering.

Stacked on top of #92 — base = feat/knowledge-graph-3d. After #92 merges, this PR's base will auto-update to main.

Test plan

  • npx vitest run — 8/8 KnowledgeGraph component tests pass; updated test pins hex output (was pinning hsl(...)) and the new course-root sizing.
  • npx tsc --noEmit — clean.
  • npm run check:lockfile — green.
  • Visual smoke test: open /learn, /tree, /dashboard — confirm each course family is visibly distinct and root nodes are noticeably larger.

🤖 Generated with Claude Code

Three.js's Color.setStyle silently rendered every node black because
shadeFor returned space-separated `hsl(120 50% 50%)` strings, which
the parser only accepts comma-separated. Switch shadeFor to hex
output, tighten hue variance ±25 → ±10 so each course family reads
as one cohesive color band, and add a deterministic palette fallback
(paletteFor in lib/data.ts) so backends without course_color still
get distinct hues per course_id. Course-root nodes pinned to a
larger fixed size (nodeVal=22) so the family center anchors the eye.
Replace var(--c-sage) screen fallbacks with resolved hex — CSS
custom properties don't survive WebGL.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitaiBot commented May 5, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 91cec15f-8c05-434c-8d8b-450d06bd293c

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/graph-family-colors

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Two fixes from PR #95 review:
1. The palette seed in apiToGraphNode preferred n.course_id over
course?.course_id. When some nodes in a family carry course_id
and others don't (falling through to subject), they hashed to
different palette colors and the family visually split. Prefer
the course-record id so all nodes in a family seed identically.
2. shadeFor used `hexToHsl(FALLBACK)!` — safe today only because
the FALLBACK constant happens to parse. Replaced with a
precomputed FALLBACK_HSL literal (`{h: 75, s: 26, l: 48}` =
#8a9a5b) so the call site can never silently break.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pagesBot commented May 5, 2026

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
frontende177171Commit Preview URL

Branch Preview URL
May 06 2026, 02:14 AM

Jose-Gael-Cruz-Lopezand others added 3 commits May 5, 2026 21:55
Three non-blocking follow-ups from PR #95 review:
1. Deduplicate the DJB2 hash (was reimplemented in lib/data.ts and
KnowledgeGraph.tsx) into a single `hashSeed` export.
2. Hoist the triplicated apiToGraphNode adapter from Tree/Learn/
Dashboard into lib/data.ts.
3. Add unit tests for paletteFor + hashSeed.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
WCAG audit against the cream `--bg` (#faf8f3) flagged two palette
entries below the 3:1 non-text-UI threshold:
- sage #8a9a5b → 2.89:1 → #7a874f (~3.5:1)
- ochre #c89c4a → 2.38:1 → #a87d2e (~3.6:1)
Both nudged darker along the same hue band so node circles stay
legible on the light theme. Brand --accent (#8a9a5b) is unchanged
elsewhere — this palette is only the backend-color fallback.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Locks down the round-2 fix: when n.course_id and course.course_id
disagree, the palette seed must come from the course record so every
node in the same family hashes to the same color. Also pins the
two simpler fallback branches and the subject_root → mastered
tier remap.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@Jose-Gael-Cruz-Lopez
Jose-Gael-Cruz-Lopez merged commit b1440d8 into feat/knowledge-graph-3dMay 6, 2026
2 checks passed
@AndresL230
AndresL230 deleted the fix/graph-family-colors branch June 27, 2026 04:21
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@Jose-Gael-Cruz-Lopez
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(graph-3d): family-distinct node colors + larger course roots - #95

Merged
Jose-Gael-Cruz-Lopez merged 5 commits into
feat/knowledge-graph-3dfrom
fix/graph-family-colors
May 6, 2026
Merged

fix(graph-3d): family-distinct node colors + larger course roots#95
Jose-Gael-Cruz-Lopez merged 5 commits into
feat/knowledge-graph-3dfrom
fix/graph-family-colors

Conversation

@Jose-Gael-Cruz-Lopez

Copy link
Copy Markdown
Member

Summary

  • Three.js was rendering every node black because shadeFor returned space-separated hsl(120 50% 50%) strings, which Color.setStyle only accepts comma-separated. Switched shadeFor to hex output via a new hslToHex helper.
  • Added paletteFor (in lib/data.ts) — a deterministic 8-color brand palette indexed by course_id. So when the backend doesn't supply a per-course color, each family still gets its own distinct hue instead of every concept collapsing onto one fallback.
  • Tightened hue variance on the per-node shading (±25 → ±10) so every child of a course reads as a clear shade of that family's color rather than drifting into a sibling's hue.
  • Course-root nodes pinned to a fixed larger nodeVal (22) so the family center anchors the eye.
  • Replaced var(--c-sage) fallbacks in Tree.tsx/Learn.tsx/Dashboard.tsx with paletteFor(course_id || subject). CSS custom properties don't survive WebGL — that fallback was contributing to all-black rendering.

Stacked on top of #92 — base = feat/knowledge-graph-3d. After #92 merges, this PR's base will auto-update to main.

Test plan

  • npx vitest run — 8/8 KnowledgeGraph component tests pass; updated test pins hex output (was pinning hsl(...)) and the new course-root sizing.
  • npx tsc --noEmit — clean.
  • npm run check:lockfile — green.
  • Visual smoke test: open /learn, /tree, /dashboard — confirm each course family is visibly distinct and root nodes are noticeably larger.

🤖 Generated with Claude Code

Three.js's Color.setStyle silently rendered every node black because
shadeFor returned space-separated `hsl(120 50% 50%)` strings, which
the parser only accepts comma-separated. Switch shadeFor to hex
output, tighten hue variance ±25 → ±10 so each course family reads
as one cohesive color band, and add a deterministic palette fallback
(paletteFor in lib/data.ts) so backends without course_color still
get distinct hues per course_id. Course-root nodes pinned to a
larger fixed size (nodeVal=22) so the family center anchors the eye.
Replace var(--c-sage) screen fallbacks with resolved hex — CSS
custom properties don't survive WebGL.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitaiBot commented May 5, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 91cec15f-8c05-434c-8d8b-450d06bd293c

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/graph-family-colors

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Two fixes from PR #95 review:
1. The palette seed in apiToGraphNode preferred n.course_id over
course?.course_id. When some nodes in a family carry course_id
and others don't (falling through to subject), they hashed to
different palette colors and the family visually split. Prefer
the course-record id so all nodes in a family seed identically.
2. shadeFor used `hexToHsl(FALLBACK)!` — safe today only because
the FALLBACK constant happens to parse. Replaced with a
precomputed FALLBACK_HSL literal (`{h: 75, s: 26, l: 48}` =
#8a9a5b) so the call site can never silently break.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pagesBot commented May 5, 2026

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
frontende177171Commit Preview URL

Branch Preview URL
May 06 2026, 02:14 AM

Jose-Gael-Cruz-Lopezand others added 3 commits May 5, 2026 21:55
Three non-blocking follow-ups from PR #95 review:
1. Deduplicate the DJB2 hash (was reimplemented in lib/data.ts and
KnowledgeGraph.tsx) into a single `hashSeed` export.
2. Hoist the triplicated apiToGraphNode adapter from Tree/Learn/
Dashboard into lib/data.ts.
3. Add unit tests for paletteFor + hashSeed.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
WCAG audit against the cream `--bg` (#faf8f3) flagged two palette
entries below the 3:1 non-text-UI threshold:
- sage #8a9a5b → 2.89:1 → #7a874f (~3.5:1)
- ochre #c89c4a → 2.38:1 → #a87d2e (~3.6:1)
Both nudged darker along the same hue band so node circles stay
legible on the light theme. Brand --accent (#8a9a5b) is unchanged
elsewhere — this palette is only the backend-color fallback.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Locks down the round-2 fix: when n.course_id and course.course_id
disagree, the palette seed must come from the course record so every
node in the same family hashes to the same color. Also pins the
two simpler fallback branches and the subject_root → mastered
tier remap.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@Jose-Gael-Cruz-Lopez
Jose-Gael-Cruz-Lopez merged commit b1440d8 into feat/knowledge-graph-3dMay 6, 2026
2 checks passed
@AndresL230
AndresL230 deleted the fix/graph-family-colors branch June 27, 2026 04:21
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@Jose-Gael-Cruz-Lopez
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix(graph-3d): family-distinct node colors + larger course roots - #95

Merged
Jose-Gael-Cruz-Lopez merged 5 commits into
feat/knowledge-graph-3dfrom
fix/graph-family-colors
May 6, 2026
Merged

fix(graph-3d): family-distinct node colors + larger course roots#95
Jose-Gael-Cruz-Lopez merged 5 commits into
feat/knowledge-graph-3dfrom
fix/graph-family-colors

Conversation

@Jose-Gael-Cruz-Lopez

Copy link
Copy Markdown
Member

Summary

  • Three.js was rendering every node black because shadeFor returned space-separated hsl(120 50% 50%) strings, which Color.setStyle only accepts comma-separated. Switched shadeFor to hex output via a new hslToHex helper.
  • Added paletteFor (in lib/data.ts) — a deterministic 8-color brand palette indexed by course_id. So when the backend doesn't supply a per-course color, each family still gets its own distinct hue instead of every concept collapsing onto one fallback.
  • Tightened hue variance on the per-node shading (±25 → ±10) so every child of a course reads as a clear shade of that family's color rather than drifting into a sibling's hue.
  • Course-root nodes pinned to a fixed larger nodeVal (22) so the family center anchors the eye.
  • Replaced var(--c-sage) fallbacks in Tree.tsx/Learn.tsx/Dashboard.tsx with paletteFor(course_id || subject). CSS custom properties don't survive WebGL — that fallback was contributing to all-black rendering.

Stacked on top of #92 — base = feat/knowledge-graph-3d. After #92 merges, this PR's base will auto-update to main.

Test plan

  • npx vitest run — 8/8 KnowledgeGraph component tests pass; updated test pins hex output (was pinning hsl(...)) and the new course-root sizing.
  • npx tsc --noEmit — clean.
  • npm run check:lockfile — green.
  • Visual smoke test: open /learn, /tree, /dashboard — confirm each course family is visibly distinct and root nodes are noticeably larger.

🤖 Generated with Claude Code

Three.js's Color.setStyle silently rendered every node black because
shadeFor returned space-separated `hsl(120 50% 50%)` strings, which
the parser only accepts comma-separated. Switch shadeFor to hex
output, tighten hue variance ±25 → ±10 so each course family reads
as one cohesive color band, and add a deterministic palette fallback
(paletteFor in lib/data.ts) so backends without course_color still
get distinct hues per course_id. Course-root nodes pinned to a
larger fixed size (nodeVal=22) so the family center anchors the eye.
Replace var(--c-sage) screen fallbacks with resolved hex — CSS
custom properties don't survive WebGL.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitaiBot commented May 5, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 91cec15f-8c05-434c-8d8b-450d06bd293c

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/graph-family-colors

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Two fixes from PR #95 review:
1. The palette seed in apiToGraphNode preferred n.course_id over
course?.course_id. When some nodes in a family carry course_id
and others don't (falling through to subject), they hashed to
different palette colors and the family visually split. Prefer
the course-record id so all nodes in a family seed identically.
2. shadeFor used `hexToHsl(FALLBACK)!` — safe today only because
the FALLBACK constant happens to parse. Replaced with a
precomputed FALLBACK_HSL literal (`{h: 75, s: 26, l: 48}` =
#8a9a5b) so the call site can never silently break.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pagesBot commented May 5, 2026

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
frontende177171Commit Preview URL

Branch Preview URL
May 06 2026, 02:14 AM

Jose-Gael-Cruz-Lopezand others added 3 commits May 5, 2026 21:55
Three non-blocking follow-ups from PR #95 review:
1. Deduplicate the DJB2 hash (was reimplemented in lib/data.ts and
KnowledgeGraph.tsx) into a single `hashSeed` export.
2. Hoist the triplicated apiToGraphNode adapter from Tree/Learn/
Dashboard into lib/data.ts.
3. Add unit tests for paletteFor + hashSeed.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
WCAG audit against the cream `--bg` (#faf8f3) flagged two palette
entries below the 3:1 non-text-UI threshold:
- sage #8a9a5b → 2.89:1 → #7a874f (~3.5:1)
- ochre #c89c4a → 2.38:1 → #a87d2e (~3.6:1)
Both nudged darker along the same hue band so node circles stay
legible on the light theme. Brand --accent (#8a9a5b) is unchanged
elsewhere — this palette is only the backend-color fallback.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Locks down the round-2 fix: when n.course_id and course.course_id
disagree, the palette seed must come from the course record so every
node in the same family hashes to the same color. Also pins the
two simpler fallback branches and the subject_root → mastered
tier remap.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@Jose-Gael-Cruz-Lopez
Jose-Gael-Cruz-Lopez merged commit b1440d8 into feat/knowledge-graph-3dMay 6, 2026
2 checks passed
@AndresL230
AndresL230 deleted the fix/graph-family-colors branch June 27, 2026 04:21
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@Jose-Gael-Cruz-Lopez
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

fix(graph-3d): family-distinct node colors + larger course roots - #95

Merged
Jose-Gael-Cruz-Lopez merged 5 commits into
feat/knowledge-graph-3dfrom
fix/graph-family-colors
May 6, 2026
Merged

fix(graph-3d): family-distinct node colors + larger course roots#95
Jose-Gael-Cruz-Lopez merged 5 commits into
feat/knowledge-graph-3dfrom
fix/graph-family-colors

Conversation

@Jose-Gael-Cruz-Lopez

Copy link
Copy Markdown
Member

Summary

  • Three.js was rendering every node black because shadeFor returned space-separated hsl(120 50% 50%) strings, which Color.setStyle only accepts comma-separated. Switched shadeFor to hex output via a new hslToHex helper.
  • Added paletteFor (in lib/data.ts) — a deterministic 8-color brand palette indexed by course_id. So when the backend doesn't supply a per-course color, each family still gets its own distinct hue instead of every concept collapsing onto one fallback.
  • Tightened hue variance on the per-node shading (±25 → ±10) so every child of a course reads as a clear shade of that family's color rather than drifting into a sibling's hue.
  • Course-root nodes pinned to a fixed larger nodeVal (22) so the family center anchors the eye.
  • Replaced var(--c-sage) fallbacks in Tree.tsx/Learn.tsx/Dashboard.tsx with paletteFor(course_id || subject). CSS custom properties don't survive WebGL — that fallback was contributing to all-black rendering.

Stacked on top of #92 — base = feat/knowledge-graph-3d. After #92 merges, this PR's base will auto-update to main.

Test plan

  • npx vitest run — 8/8 KnowledgeGraph component tests pass; updated test pins hex output (was pinning hsl(...)) and the new course-root sizing.
  • npx tsc --noEmit — clean.
  • npm run check:lockfile — green.
  • Visual smoke test: open /learn, /tree, /dashboard — confirm each course family is visibly distinct and root nodes are noticeably larger.

🤖 Generated with Claude Code

Three.js's Color.setStyle silently rendered every node black because
shadeFor returned space-separated `hsl(120 50% 50%)` strings, which
the parser only accepts comma-separated. Switch shadeFor to hex
output, tighten hue variance ±25 → ±10 so each course family reads
as one cohesive color band, and add a deterministic palette fallback
(paletteFor in lib/data.ts) so backends without course_color still
get distinct hues per course_id. Course-root nodes pinned to a
larger fixed size (nodeVal=22) so the family center anchors the eye.
Replace var(--c-sage) screen fallbacks with resolved hex — CSS
custom properties don't survive WebGL.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitaiBot commented May 5, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 91cec15f-8c05-434c-8d8b-450d06bd293c

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/graph-family-colors

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Two fixes from PR #95 review:
1. The palette seed in apiToGraphNode preferred n.course_id over
course?.course_id. When some nodes in a family carry course_id
and others don't (falling through to subject), they hashed to
different palette colors and the family visually split. Prefer
the course-record id so all nodes in a family seed identically.
2. shadeFor used `hexToHsl(FALLBACK)!` — safe today only because
the FALLBACK constant happens to parse. Replaced with a
precomputed FALLBACK_HSL literal (`{h: 75, s: 26, l: 48}` =
#8a9a5b) so the call site can never silently break.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pagesBot commented May 5, 2026

Copy link
Copy Markdown

Deploying with Cloudflare Workers Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

StatusNameLatest CommitPreview URLUpdated (UTC)
✅ Deployment successful!
View logs
frontende177171Commit Preview URL

Branch Preview URL
May 06 2026, 02:14 AM

Jose-Gael-Cruz-Lopezand others added 3 commits May 5, 2026 21:55
Three non-blocking follow-ups from PR #95 review:
1. Deduplicate the DJB2 hash (was reimplemented in lib/data.ts and
KnowledgeGraph.tsx) into a single `hashSeed` export.
2. Hoist the triplicated apiToGraphNode adapter from Tree/Learn/
Dashboard into lib/data.ts.
3. Add unit tests for paletteFor + hashSeed.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
WCAG audit against the cream `--bg` (#faf8f3) flagged two palette
entries below the 3:1 non-text-UI threshold:
- sage #8a9a5b → 2.89:1 → #7a874f (~3.5:1)
- ochre #c89c4a → 2.38:1 → #a87d2e (~3.6:1)
Both nudged darker along the same hue band so node circles stay
legible on the light theme. Brand --accent (#8a9a5b) is unchanged
elsewhere — this palette is only the backend-color fallback.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Locks down the round-2 fix: when n.course_id and course.course_id
disagree, the palette seed must come from the course record so every
node in the same family hashes to the same color. Also pins the
two simpler fallback branches and the subject_root → mastered
tier remap.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@Jose-Gael-Cruz-Lopez
Jose-Gael-Cruz-Lopez merged commit b1440d8 into feat/knowledge-graph-3dMay 6, 2026
2 checks passed
@AndresL230
AndresL230 deleted the fix/graph-family-colors branch June 27, 2026 04:21
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@Jose-Gael-Cruz-Lopez