@retiregolden/planner-ui 0.1.0

package/src/learn/inlineMarkdown.tsx

@@ -0,0 +1,54 @@
+/**
+ * Tiny, dependency-free inline renderer for article prose.
+ *
+ * Supports just enough Markdown for body text — links, bold, and inline code —
+ * and builds real React elements (never `dangerouslySetInnerHTML`), so author
+ * content cannot inject raw HTML. Block structure (paragraphs, lists, headings)
+ * is handled by ArticleBody; this only handles inline spans within one string.
+ */
+
+import type { ReactNode } from 'react'
+import { Link } from 'react-router-dom'
+
+// link [text](href) | bold **text** | inline code `code`
+const INLINE_PATTERN = /\[([^\]]+)\]\(([^)]+)\)|\*\*([^*]+)\*\*|`([^`]+)`/g
+
+/** Render a single line/paragraph of constrained Markdown to React nodes. */
+export function renderInline(text: string): ReactNode[] {
+  const nodes: ReactNode[] = []
+  let lastIndex = 0
+  let key = 0
+
+  for (const match of text.matchAll(INLINE_PATTERN)) {
+    const start = match.index ?? 0
+    if (start > lastIndex) nodes.push(text.slice(lastIndex, start))
+
+    const [linkText, href] = [match[1], match[2]]
+    const boldText = match[3]
+    const codeText = match[4]
+
+    if (linkText !== undefined && href !== undefined) {
+      // Internal links use the router; external links open in a new tab.
+      nodes.push(
+        href.startsWith('/') ? (
+          <Link key={key++} to={href}>
+            {linkText}
+          </Link>
+        ) : (
+          <a key={key++} href={href} target="_blank" rel="noreferrer">
+            {linkText}
+          </a>
+        ),
+      )
+    } else if (boldText !== undefined) {
+      nodes.push(<strong key={key++}>{boldText}</strong>)
+    } else if (codeText !== undefined) {
+      nodes.push(<code key={key++}>{codeText}</code>)
+    }
+
+    lastIndex = start + match[0].length
+  }
+
+  if (lastIndex < text.length) nodes.push(text.slice(lastIndex))
+  return nodes
+}

package/src/learn/learn.css

@@ -0,0 +1,537 @@
+/* Learning Center (V9). Uses the global design tokens from index.css. */
+
+.learn-home,
+.learn-article,
+.learn-glossary,
+.learn-sources-page {
+  max-width: 48rem;
+  margin: 0 auto;
+  text-align: left;
+}
+
+/* Reading surfaces get a tighter measure (~75ch at the article font size);
+   the card-grid home keeps the wider column. */
+.learn-article,
+.learn-glossary,
+.learn-sources-page {
+  max-width: 42rem;
+}
+
+/* --- Search ----------------------------------------------------------------*/
+.learn-search {
+  margin: 0 0 1.75rem;
+}
+
+.learn-search-input {
+  width: 100%;
+  padding: 0.6rem 0.8rem;
+  border-radius: var(--radius);
+  border: 1px solid var(--border);
+  background: var(--surface-1);
+  color: var(--fg);
+  font-size: 1rem;
+}
+
+.learn-search-input:focus-visible {
+  outline: 2px solid var(--accent);
+  outline-offset: 1px;
+}
+
+/* --- Sections --------------------------------------------------------------*/
+.learn-section {
+  margin: 0 0 2rem;
+}
+
+.learn-section-title {
+  font-size: 1.2rem;
+  margin: 0 0 0.85rem;
+}
+
+.learn-category {
+  margin: 0 0 1.5rem;
+}
+
+.learn-category-head {
+  display: flex;
+  align-items: baseline;
+  justify-content: space-between;
+  gap: 0.75rem;
+}
+
+.learn-category-title {
+  font-size: 1.05rem;
+  margin: 0 0 0.15rem;
+}
+
+.learn-category-blurb {
+  margin: 0 0 0.75rem;
+  font-size: 0.92rem;
+  max-width: 70ch;
+}
+
+/* --- Cards -----------------------------------------------------------------*/
+.learn-card-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(15rem, 1fr));
+  gap: 0.85rem;
+}
+
+.learn-card {
+  display: flex;
+  flex-direction: column;
+  gap: 0.3rem;
+  padding: 0.85rem 0.95rem;
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  background: var(--surface-1);
+  text-decoration: none;
+  color: inherit;
+}
+
+.learn-card--link {
+  box-shadow: var(--shadow-card);
+  transition:
+    transform 0.12s ease,
+    border-color 0.12s ease;
+}
+
+.learn-card--link:hover {
+  border-color: color-mix(in srgb, var(--accent) 45%, var(--border));
+  transform: translateY(-1px);
+}
+
+.learn-card--link:focus-visible {
+  outline: 2px solid var(--accent);
+  outline-offset: 2px;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .learn-card--link {
+    transition: none;
+  }
+
+  .learn-card--link:hover {
+    transform: none;
+  }
+}
+
+.learn-card--planned {
+  background: color-mix(in srgb, var(--fg) 3%, transparent);
+  border-style: dashed;
+}
+
+.learn-card-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 0.5rem;
+}
+
+.learn-card-cat {
+  font-size: 0.74rem;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: var(--accent);
+  font-weight: 600;
+}
+
+.learn-card-title {
+  font-weight: 600;
+  font-size: 1rem;
+  line-height: 1.3;
+}
+
+.learn-card-desc {
+  font-size: 0.9rem;
+  color: var(--muted);
+  line-height: 1.4;
+}
+
+.learn-badge {
+  font-size: 0.7rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  padding: 0.1rem 0.4rem;
+  border-radius: 999px;
+}
+
+.learn-badge--planned {
+  color: var(--muted);
+  background: color-mix(in srgb, var(--fg) 8%, transparent);
+}
+
+/* --- Utility links (glossary, sources) -------------------------------------*/
+.learn-utility-links {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(15rem, 1fr));
+  gap: 0.85rem;
+}
+
+.learn-utility-link {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+  padding: 0.85rem 0.95rem;
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  background: var(--surface-1);
+  text-decoration: none;
+  color: inherit;
+  box-shadow: var(--shadow-card);
+}
+
+.learn-utility-link:hover {
+  border-color: color-mix(in srgb, var(--accent) 45%, var(--border));
+}
+
+.learn-utility-link:focus-visible {
+  outline: 2px solid var(--accent);
+  outline-offset: 2px;
+}
+
+/* --- LearnLink + contextual cluster ----------------------------------------*/
+/* The one component the app uses to link out to the Learning Center. */
+.learn-link {
+  color: var(--accent);
+  text-decoration: none;
+  font-size: 0.9rem;
+}
+
+.learn-link:hover {
+  text-decoration: underline;
+}
+
+.learn-link:focus-visible {
+  outline: 2px solid var(--accent);
+  outline-offset: 2px;
+  border-radius: 3px;
+}
+
+.learn-link--tip {
+  font-size: 0.8rem;
+  font-weight: 600;
+}
+
+.learn-link--button {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.2rem;
+  padding: 0.3rem 0.7rem;
+  border: 1px solid color-mix(in srgb, var(--accent) 45%, var(--border));
+  border-radius: 999px;
+  font-weight: 600;
+}
+
+.learn-link--button:hover {
+  text-decoration: none;
+  border-color: var(--accent);
+  background: color-mix(in srgb, var(--accent) 8%, transparent);
+}
+
+/* "Learn about this screen" cluster placed on planner screens. */
+.learn-screen {
+  margin-top: 1.25rem;
+  padding-top: 0.85rem;
+  border-top: 1px dashed var(--border);
+}
+
+.learn-screen-title {
+  display: block;
+  font-size: 0.74rem;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: var(--muted);
+  font-weight: 600;
+  margin-bottom: 0.4rem;
+}
+
+.learn-screen-list {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.35rem 1.1rem;
+}
+
+.learn-screen-list li {
+  margin: 0;
+}
+
+/* --- Article ---------------------------------------------------------------*/
+.learn-back {
+  display: inline-block;
+  margin-bottom: 0.75rem;
+  color: var(--accent);
+  text-decoration: none;
+  font-size: 0.9rem;
+}
+
+.learn-back:hover {
+  text-decoration: underline;
+}
+
+.learn-article-kicker {
+  margin-bottom: 0.25rem;
+}
+
+.learn-article-body {
+  font-size: 1.02rem;
+  line-height: 1.65;
+}
+
+.learn-article-body h2 {
+  font-size: 1.25rem;
+  margin: 1.75rem 0 0.6rem;
+}
+
+.learn-article-body h3 {
+  font-size: 1.08rem;
+  margin: 1.4rem 0 0.5rem;
+}
+
+.learn-article-body p {
+  margin: 0 0 0.9rem;
+}
+
+.learn-list {
+  margin: 0 0 1rem;
+  padding-left: 1.3rem;
+}
+
+.learn-list li {
+  margin-bottom: 0.4rem;
+}
+
+.learn-callout {
+  margin: 1rem 0 1.25rem;
+  padding: 0.75rem 1rem;
+  border-radius: var(--radius);
+  border: 1px solid var(--border);
+}
+
+.learn-callout p {
+  margin: 0;
+}
+
+.learn-callout p + p {
+  margin-top: 0.6rem;
+}
+
+.learn-callout--note {
+  background: color-mix(in srgb, var(--accent) 8%, transparent);
+  border-color: color-mix(in srgb, var(--accent) 40%, var(--border));
+}
+
+.learn-callout--warn {
+  background: color-mix(in srgb, var(--warn) 12%, transparent);
+  border-color: color-mix(in srgb, var(--warn) 45%, var(--border));
+}
+
+.learn-article-foot {
+  margin-top: 2rem;
+  padding-top: 1rem;
+  border-top: 1px solid var(--border);
+}
+
+.learn-article-foot p {
+  margin: 0.35rem 0 0;
+}
+
+/* --- Glossary --------------------------------------------------------------*/
+.learn-glossary-list {
+  margin: 0;
+}
+
+.learn-glossary-item {
+  padding: 0.75rem 0;
+  border-bottom: 1px solid var(--border);
+  scroll-margin-top: 1rem;
+}
+
+.learn-glossary-item:target {
+  background: color-mix(in srgb, var(--accent) 10%, transparent);
+  border-radius: 6px;
+}
+
+.learn-glossary-term {
+  font-weight: 600;
+}
+
+.learn-glossary-expansion {
+  font-weight: 400;
+  color: var(--muted);
+}
+
+.learn-glossary-def {
+  margin: 0.25rem 0 0;
+  color: var(--fg);
+}
+
+/* --- Figure ----------------------------------------------------------------*/
+.learn-figure {
+  margin: 1.5rem 0;
+}
+
+.learn-figure-media {
+  width: 100%;
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  background: var(--surface-1);
+  padding: 0.75rem 0.5rem 0.5rem;
+}
+
+img.learn-figure-media {
+  display: block;
+  height: auto;
+  padding: 0;
+}
+
+.learn-chart-wrap {
+  width: 100%;
+  height: 280px;
+}
+
+.learn-figure-fallback {
+  margin: 0;
+  padding: 1rem;
+  border: 1px dashed var(--border);
+  border-radius: var(--radius);
+}
+
+.learn-figure-caption {
+  margin-top: 0.5rem;
+  font-size: 0.9rem;
+  color: var(--muted);
+}
+
+.learn-figure-source {
+  display: block;
+  margin-top: 0.2rem;
+  font-size: 0.82rem;
+  font-style: italic;
+}
+
+/* --- Formula ---------------------------------------------------------------*/
+.learn-formula {
+  margin: 1.25rem 0;
+  padding: 1rem 1.1rem;
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  background: color-mix(in srgb, var(--fg) 3%, transparent);
+}
+
+.learn-formula-expr {
+  margin: 0;
+  font-family: ui-monospace, 'Cascadia Code', 'Consolas', monospace;
+  font-size: 1.02rem;
+  line-height: 1.5;
+}
+
+.learn-formula-where {
+  margin: 0.85rem 0 0;
+}
+
+.learn-formula-row {
+  display: grid;
+  grid-template-columns: minmax(6rem, max-content) 1fr;
+  gap: 0.35rem 0.9rem;
+  padding: 0.2rem 0;
+}
+
+.learn-formula-row dt {
+  font-family: ui-monospace, 'Cascadia Code', 'Consolas', monospace;
+  font-size: 0.9rem;
+  color: var(--accent);
+}
+
+.learn-formula-row dd {
+  margin: 0;
+  font-size: 0.92rem;
+}
+
+.learn-formula-note {
+  margin: 0.75rem 0 0;
+}
+
+/* --- Scenario --------------------------------------------------------------*/
+.learn-scenario {
+  margin: 1.25rem 0;
+  padding: 1rem 1.1rem;
+  border: 1px solid color-mix(in srgb, var(--accent) 40%, var(--border));
+  border-radius: var(--radius);
+  background: var(--surface-1);
+}
+
+.learn-scenario-name {
+  margin: 0 0 0.6rem;
+  font-weight: 600;
+}
+
+.learn-scenario-grid {
+  margin: 0;
+}
+
+.learn-scenario-row {
+  display: grid;
+  grid-template-columns: minmax(8rem, max-content) 1fr;
+  gap: 0.3rem 1rem;
+  padding: 0.25rem 0;
+  border-top: 1px solid var(--border);
+}
+
+.learn-scenario-row:first-child {
+  border-top: none;
+}
+
+.learn-scenario-row dt {
+  color: var(--muted);
+  font-size: 0.92rem;
+}
+
+.learn-scenario-row dd {
+  margin: 0;
+  font-weight: 600;
+}
+
+.learn-scenario-summary {
+  margin: 0.85rem 0 0;
+}
+
+/* --- Comparison table ------------------------------------------------------*/
+.learn-table-wrap {
+  margin: 1.25rem 0;
+  overflow-x: auto;
+}
+
+.learn-table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 0.95rem;
+}
+
+.learn-table-caption {
+  caption-side: top;
+  text-align: left;
+  margin-bottom: 0.5rem;
+  font-size: 0.9rem;
+  color: var(--muted);
+}
+
+.learn-table th,
+.learn-table td {
+  border: 1px solid var(--border);
+  padding: 0.5rem 0.7rem;
+  text-align: left;
+  vertical-align: top;
+}
+
+.learn-table thead th {
+  background: color-mix(in srgb, var(--fg) 6%, transparent);
+}
+
+.learn-table tbody th[scope='row'] {
+  background: color-mix(in srgb, var(--fg) 3%, transparent);
+  font-weight: 600;
+}