@markuxt/markuxt 0.1.4

package/src/server/plugins/content-locale.ts

@@ -0,0 +1,47 @@
+// Content locale detection from filename suffixes.
+//
+// Recognizes locale from Markdown filenames:
+//   - `page.md`          → locale 'en' (default)
+//   - `page.en.md`       → locale 'en'
+//   - `page.en-US.md`    → locale 'en'
+//   - `page.zh.md`       → locale 'zh-CN'
+//   - `page.zh-CN.md`    → locale 'zh-CN'
+//
+// Sets `file.locale` and normalizes `_path` so locale variants
+// share the same path (e.g. `salman-ijaz.zh-CN.md` → `/members/staff/salman-ijaz`).
+
+const LOCALE_PATTERN = /\.(en|en-US|zh|zh-CN)\.md$/
+
+// Normalize locale codes to the canonical form used by @nuxtjs/i18n
+function normalizeLocale(raw: string): string {
+  if (raw === 'en-US' || raw === 'en') return 'en'
+  if (raw === 'zh' || raw === 'zh-CN') return 'zh-CN'
+  return raw
+}
+
+export default defineNitroPlugin((nitroApp) => {
+  nitroApp.hooks.hook('content:file:afterParse', (file: any) => {
+    if (!file?._id || typeof file._id !== 'string') return
+
+    // Only process Markdown files
+    if (!file._id.endsWith('.md')) return
+
+    const match = file._id.match(LOCALE_PATTERN)
+
+    if (match) {
+      file.locale = normalizeLocale(match[1])
+
+      // Strip locale suffix from _path so variants share the same route
+      // e.g. `/members/staff/salman-ijaz-zh-cn` → `/members/staff/salman-ijaz`
+      if (file._path) {
+        file._path = file._path.replace(
+          new RegExp(`-(?:en|en-US|zh|zh-CN)$`),
+          ''
+        )
+      }
+    } else {
+      // No locale suffix = default locale
+      file.locale = 'en'
+    }
+  })
+})

package/src/server/plugins/fix-content-anchors.ts

@@ -0,0 +1,63 @@
+// Fix in-page anchor links for content pasted from GitHub READMEs.
+//
+// Background: when a heading like `## 🧭 Start Here` is parsed, github-slugger
+// produces `-start-here` (emoji dropped, leading dash kept). GitHub uses that
+// exact string as the heading's anchor, so hand-written tables of contents link
+// to `#-start-here`. Nuxt Content's MDC compiler, however, runs one extra step
+// GitHub does not — it strips the leading/trailing dashes — so the heading's id
+// becomes `start-here`. The result: every emoji-prefixed TOC link 404s in-page.
+//
+// Rather than rewrite the markdown (which is correct GitHub syntax), we
+// normalize the anchor hrefs at parse time using the SAME rule MDC applies to
+// heading ids, so the links converge onto the generated ids. Idempotent, and we
+// only rewrite a link when doing so actually points it at a real heading.
+
+// Mirror of MDC's heading-id tail normalization (compiler.js):
+//   slug(text).replace(/-+/g, '-').replace(/^-|-$/g, '').replace(/^(\d)/, '_$1')
+function normalizeId(fragment: string): string {
+  return fragment
+    .replace(/-+/g, '-')
+    .replace(/^-|-$/g, '')
+    .replace(/^(\d)/, '_$1')
+}
+
+// Collect ids of all heading nodes (h1–h6) in the parsed body AST.
+function collectHeadingIds(node: any, ids: Set<string>): void {
+  if (!node || typeof node !== 'object') return
+  if (Array.isArray(node)) {
+    for (const child of node) collectHeadingIds(child, ids)
+    return
+  }
+  if (typeof node.tag === 'string' && /^h[1-6]$/.test(node.tag) && node.props?.id) {
+    ids.add(node.props.id)
+  }
+  if (node.children) collectHeadingIds(node.children, ids)
+}
+
+// Rewrite in-page anchor hrefs that only match a heading after normalization.
+function fixAnchors(node: any, ids: Set<string>): void {
+  if (!node || typeof node !== 'object') return
+  if (Array.isArray(node)) {
+    for (const child of node) fixAnchors(child, ids)
+    return
+  }
+  if (node.tag === 'a' && typeof node.props?.href === 'string' && node.props.href.startsWith('#')) {
+    const fragment = node.props.href.slice(1)
+    if (fragment && !ids.has(fragment)) {
+      const normalized = normalizeId(fragment)
+      if (ids.has(normalized)) {
+        node.props.href = '#' + normalized
+      }
+    }
+  }
+  if (node.children) fixAnchors(node.children, ids)
+}
+
+export default defineNitroPlugin((nitroApp) => {
+  nitroApp.hooks.hook('content:file:afterParse', (file: any) => {
+    if (!file?._id?.endsWith('.md') || !file.body?.children) return
+    const ids = new Set<string>()
+    collectHeadingIds(file.body, ids)
+    if (ids.size) fixAnchors(file.body, ids)
+  })
+})

package/src/styles/_animations.css

@@ -0,0 +1,99 @@
+/* ============================================
+   Animation Classes
+   ============================================ */
+
+@keyframes fadeInUp {
+  from {
+    opacity: 0;
+    transform: translateY(20px);
+  }
+  to {
+    opacity: 1;
+    transform: translateY(0);
+  }
+}
+
+@keyframes fadeIn {
+  from {
+    opacity: 0;
+  }
+  to {
+    opacity: 1;
+  }
+}
+
+@keyframes slideInLeft {
+  from {
+    opacity: 0;
+    transform: translateX(-30px);
+  }
+  to {
+    opacity: 1;
+    transform: translateX(0);
+  }
+}
+
+@keyframes slideInRight {
+  from {
+    opacity: 0;
+    transform: translateX(30px);
+  }
+  to {
+    opacity: 1;
+    transform: translateX(0);
+  }
+}
+
+.animate-fade-in-up {
+  animation: fadeInUp 0.6s ease forwards;
+}
+
+.animate-fade-in {
+  animation: fadeIn 0.4s ease forwards;
+}
+
+.animate-slide-left {
+  animation: slideInLeft 0.5s ease forwards;
+}
+
+.animate-slide-right {
+  animation: slideInRight 0.5s ease forwards;
+}
+
+/* Stagger delays */
+.delay-100 {
+  animation-delay: 0.1s;
+}
+.delay-200 {
+  animation-delay: 0.2s;
+}
+.delay-300 {
+  animation-delay: 0.3s;
+}
+.delay-400 {
+  animation-delay: 0.4s;
+}
+.delay-500 {
+  animation-delay: 0.5s;
+}
+
+/* ============================================
+   Page Transitions
+   ============================================ */
+
+.page-enter-active,
+.page-leave-active {
+  transition:
+    opacity 0.3s ease,
+    transform 0.3s ease;
+}
+
+.page-enter-from {
+  opacity: 0;
+  transform: translateY(10px);
+}
+
+.page-leave-to {
+  opacity: 0;
+  transform: translateY(-10px);
+}

package/src/styles/_base.css

@@ -0,0 +1,31 @@
+/* ============================================
+   Base Styles
+   ============================================ */
+
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+html {
+  font-size: 16px;
+  scroll-behavior: smooth;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+body {
+  font-family: var(--font-body);
+  font-size: 1rem;
+  line-height: 1.6;
+  color: var(--color-text);
+  background-color: var(--color-bg);
+  background-image:
+    linear-gradient(rgba(10, 37, 64, 0.02) 1px, transparent 1px),
+    linear-gradient(90deg, rgba(10, 37, 64, 0.02) 1px, transparent 1px);
+  background-size: 40px 40px;
+  min-height: 100vh;
+}

package/src/styles/_code.css

@@ -0,0 +1,109 @@
+/* ============================================
+   Markdown Code Blocks (ProsePre override)
+   Light theme: very light grey surface, subtle border
+   ============================================ */
+
+/* Wrapper around a highlighted code block */
+.code-block {
+  margin: var(--spacing-lg) 0;
+  border: 1px solid var(--color-border);
+  border-radius: var(--radius-lg);
+  overflow: hidden;
+  background: #f6f8fa;
+  box-shadow: var(--shadow-sm);
+}
+
+/* Header strip: language label + copy button */
+.code-block__header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--spacing-md);
+  padding: var(--spacing-xs) var(--spacing-md);
+  background: #eaeef2;
+  border-bottom: 1px solid var(--color-border);
+}
+
+.code-block__lang {
+  font-family: var(--font-body);
+  font-size: 0.75rem;
+  font-weight: 600;
+  letter-spacing: 0.04em;
+  text-transform: uppercase;
+  color: var(--color-text-muted);
+}
+
+.code-block__copy {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  padding: 0.3rem;
+  color: var(--color-text-muted);
+  background: transparent;
+  border: none;
+  border-radius: var(--radius-sm);
+  cursor: pointer;
+  transition: all var(--transition-fast);
+}
+
+.code-block__copy:hover {
+  background: rgba(0, 0, 0, 0.06);
+  color: var(--color-text);
+}
+
+.code-block__copy.is-copied {
+  color: #1a7f37;
+}
+
+/* The <pre> emitted inside our wrapper: reset chrome, keep scrolling */
+.code-block pre {
+  margin: 0;
+  padding: var(--spacing-md) var(--spacing-lg);
+  overflow-x: auto;
+  background: transparent;
+  font-size: 0.875rem;
+  line-height: 1.6;
+  -webkit-overflow-scrolling: touch;
+}
+
+.code-block pre code {
+  font-family: ui-monospace, 'SF Mono', 'Cascadia Code', 'Fira Code', Menlo, Consolas, monospace;
+  font-size: inherit;
+  color: var(--color-text);
+  background: none;
+  padding: 0;
+  display: block;
+  counter-reset: line;
+}
+
+.code-block pre code .line {
+  display: block;
+}
+
+/* Line-number gutter: rendered from a CSS counter so the digits are never
+   part of the copied text (manual selection skips ::before; the copy button
+   copies the raw source). Sticky so numbers stay pinned while a long line
+   scrolls horizontally, GitHub-style. */
+.code-block pre code .line::before {
+  counter-increment: line;
+  content: counter(line);
+  position: sticky;
+  left: 0;
+  display: inline-block;
+  width: 2.5ch;
+  margin-right: var(--spacing-md);
+  padding-right: var(--spacing-sm);
+  text-align: right;
+  color: var(--color-text-muted);
+  background: #f6f8fa;
+  border-right: 1px solid var(--color-border);
+  user-select: none;
+  -webkit-user-select: none;
+}
+
+/* Shiki dual-theme: the parser writes both colors as CSS vars
+   (--shiki-default = github-light, --shiki-dusk = github-dark) rather than a
+   plain `color`. We render on a light surface, so use the light-theme var. */
+.code-block pre code span {
+  color: var(--shiki-default, inherit);
+}

package/src/styles/_components.css

@@ -0,0 +1,109 @@
+/* ============================================
+   Components
+   ============================================ */
+
+/* IconPark / inline icon helper */
+.icon-inline {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  vertical-align: middle;
+}
+.icon-inline svg {
+  display: block;
+}
+
+/* Buttons */
+.btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: var(--spacing-sm);
+  padding: var(--spacing-sm) var(--spacing-lg);
+  font-family: var(--font-body);
+  font-size: 0.875rem;
+  font-weight: 600;
+  line-height: 1;
+  text-align: center;
+  text-decoration: none;
+  border: none;
+  border-radius: var(--radius-md);
+  cursor: pointer;
+  transition: all var(--transition-base);
+}
+
+.btn-primary {
+  background: linear-gradient(
+    135deg,
+    var(--color-accent) 0%,
+    var(--color-secondary) 100%
+  );
+  color: white;
+}
+
+.btn-primary:hover {
+  transform: translateY(-2px);
+  box-shadow: 0 10px 20px -5px rgba(0, 217, 255, 0.4);
+}
+
+.btn-secondary {
+  background-color: transparent;
+  color: var(--color-primary);
+  border: 2px solid var(--color-primary);
+}
+
+.btn-secondary:hover {
+  background-color: var(--color-primary);
+  color: white;
+}
+
+/* Cards */
+.card {
+  background: var(--color-bg-alt);
+  border-radius: var(--radius-xl);
+  padding: var(--spacing-xl);
+  box-shadow: var(--shadow-md);
+  border: 1px solid var(--color-border);
+  transition: all var(--transition-base);
+}
+
+.card:hover {
+  transform: translateY(-4px);
+  box-shadow: var(--shadow-xl);
+  border-color: var(--color-secondary);
+}
+
+/* Badge */
+.badge {
+  display: inline-flex;
+  align-items: center;
+  padding: var(--spacing-xs) var(--spacing-sm);
+  font-size: 0.75rem;
+  font-weight: 600;
+  line-height: 1;
+  border-radius: var(--radius-full);
+  background-color: var(--color-secondary);
+  color: white;
+}
+
+.badge-accent {
+  background-color: var(--color-accent);
+}
+
+.badge-muted {
+  background-color: var(--color-border);
+  color: var(--color-text-muted);
+}
+
+/* Divider */
+.divider {
+  width: 100%;
+  height: 2px;
+  background: linear-gradient(
+    90deg,
+    transparent,
+    var(--color-border),
+    transparent
+  );
+  margin: var(--spacing-2xl) 0;
+}

package/src/styles/_layout.css

@@ -0,0 +1,220 @@
+/* ============================================
+   Base Styles
+   ============================================ */
+
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+html {
+  font-size: 16px;
+  scroll-behavior: smooth;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+body {
+  font-family: var(--font-body);
+  font-size: 1rem;
+  line-height: 1.6;
+  color: var(--color-text);
+  background-color: var(--color-bg);
+  background-image:
+    linear-gradient(rgba(10, 37, 64, 0.02) 1px, transparent 1px),
+    linear-gradient(90deg, rgba(10, 37, 64, 0.02) 1px, transparent 1px);
+  background-size: 40px 40px;
+  min-height: 100vh;
+}
+
+/* ============================================
+   Typography
+   ============================================ */
+
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+  font-family: var(--font-display);
+  font-weight: 700;
+  line-height: 1.2;
+  color: var(--color-primary);
+  margin-bottom: var(--spacing-md);
+  scroll-margin-top: calc(var(--header-height) + var(--spacing-lg));
+}
+
+h1 {
+  font-size: clamp(2.5rem, 5vw, 4rem);
+  font-weight: 800;
+  letter-spacing: -0.02em;
+}
+
+h2 {
+  font-size: clamp(2rem, 4vw, 2.5rem);
+  font-weight: 700;
+  letter-spacing: -0.01em;
+}
+
+h3 {
+  font-size: clamp(1.5rem, 3vw, 1.875rem);
+  font-weight: 600;
+}
+
+h4 {
+  font-size: 1.25rem;
+  font-weight: 600;
+}
+
+p {
+  margin-bottom: var(--spacing-md);
+}
+
+/* Lists */
+ul {
+  margin-bottom: var(--spacing-md);
+  padding-left: 0;
+  list-style: none !important;
+}
+
+ol {
+  margin-bottom: var(--spacing-md);
+  padding-left: 0;
+  list-style: none !important;
+  counter-reset: item;
+}
+
+li {
+  margin-bottom: var(--spacing-xs);
+  position: relative;
+  padding-left: 1.5rem;
+}
+
+ul > li::before {
+  content: '•' !important;
+  position: absolute !important;
+  left: 0 !important;
+  color: var(--color-secondary) !important;
+}
+
+ol > li::before {
+  content: counter(item) '.' !important;
+  counter-increment: item !important;
+  position: absolute !important;
+  left: 0 !important;
+  color: var(--color-secondary) !important;
+  font-weight: 600 !important;
+}
+
+/* Ensure ol li doesn't get ul's bullet */
+ol li::before {
+  content: counter(item) '.' !important;
+}
+
+/* Task lists (GitHub-style checkboxes): the global `ul > li::before` bullet
+   and `li` indent don't apply here — the checkbox is the marker. Suppress the
+   blue dot and vertically center the box with its label line via flex. */
+.task-list-item {
+  display: flex;
+  align-items: center;
+  padding-left: 0;
+  list-style: none;
+}
+
+.task-list-item::before {
+  content: none !important;
+}
+
+/* Custom checkbox: replace the native control (which is disabled/read-only for
+   markdown task lists) with a box that matches the design system. Flex-center
+   so the checkmark sits in the middle of the box on both axes. */
+.task-list-item input[type='checkbox'] {
+  appearance: none;
+  -webkit-appearance: none;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+  width: 1.05em;
+  height: 1.05em;
+  margin: 0 var(--spacing-sm) 0 0;
+  background: var(--color-bg-alt);
+  border: 2px solid var(--color-border);
+  border-radius: var(--radius-sm);
+  cursor: default;
+  transition: all var(--transition-fast);
+}
+
+/* Checked: accent fill + a CSS-drawn checkmark */
+.task-list-item input[type='checkbox']:checked {
+  background: var(--color-secondary);
+  border-color: var(--color-secondary);
+}
+
+.task-list-item input[type='checkbox']:checked::after {
+  content: '';
+  width: 0.3em;
+  height: 0.55em;
+  margin-top: -0.1em;
+  border: solid #fff;
+  border-width: 0 0.16em 0.16em 0;
+  transform: rotate(45deg);
+}
+
+a {
+  color: var(--color-secondary);
+  text-decoration: none;
+  transition: color var(--transition-fast);
+}
+
+a:hover {
+  color: var(--color-accent);
+}
+
+/* ============================================
+   Layout
+   ============================================ */
+
+.container {
+  width: 100%;
+  max-width: 1280px;
+  margin-left: auto;
+  margin-right: auto;
+  padding-left: var(--spacing-lg);
+  padding-right: var(--spacing-lg);
+}
+
+.container-narrow {
+  width: 100%;
+  max-width: 896px;
+  margin-left: auto;
+  margin-right: auto;
+  padding-left: var(--spacing-lg);
+  padding-right: var(--spacing-lg);
+}
+
+.section {
+  padding-top: var(--spacing-3xl);
+  padding-bottom: var(--spacing-3xl);
+}
+
+.grid {
+  display: grid;
+  gap: var(--spacing-xl);
+}
+
+.grid-2 {
+  grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
+}
+
+.grid-3 {
+  grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
+}
+
+.grid-4 {
+  grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
+}