create-neutron 0.1.0

package/templates/docs/src/styles/docs.css

@@ -0,0 +1,416 @@
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap');
+@import './prose.css';
+@import './code.css';
+@import './components.css';
+@import './search.css';
+
+/* Theme tokens */
+:root {
+  --nd-bg: #09090b;
+  --nd-fg: #fafafa;
+  --nd-muted: #a1a1aa;
+  --nd-border: hsla(0, 0%, 40%, 0.2);
+  --nd-accent: #818cf8;
+  --nd-sidebar-bg: #09090b;
+  --nd-card-bg: hsla(0, 0%, 100%, 0.03);
+  --nd-card-hover: hsla(0, 0%, 100%, 0.06);
+  --nd-code-bg: #18181b;
+  --nd-radius: 0.5rem;
+  --nd-sidebar-width: 17rem;
+  --nd-toc-width: 15rem;
+  --nd-content-max: 52rem;
+}
+
+[data-theme="light"] {
+  --nd-bg: #fafafa;
+  --nd-fg: #18181b;
+  --nd-muted: #71717a;
+  --nd-border: hsla(0, 0%, 0%, 0.08);
+  --nd-accent: #6366f1;
+  --nd-sidebar-bg: #fafafa;
+  --nd-card-bg: hsla(0, 0%, 0%, 0.03);
+  --nd-card-hover: hsla(0, 0%, 0%, 0.06);
+  --nd-code-bg: #f4f4f5;
+}
+
+/* Base reset */
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+  margin: 0;
+}
+
+html {
+  font-family: 'Inter', system-ui, -apple-system, sans-serif;
+  font-size: 1rem;
+  line-height: 1.75;
+  background: var(--nd-bg);
+  color: var(--nd-fg);
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+body {
+  margin: 0;
+  min-height: 100vh;
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+}
+
+/* Three-column docs layout */
+.docs-layout {
+  display: grid;
+  grid-template-columns: var(--nd-sidebar-width) minmax(0, 1fr) var(--nd-toc-width);
+  max-width: 1400px;
+  margin: 0 auto;
+  min-height: 100vh;
+}
+
+/* Sidebar */
+.docs-sidebar {
+  position: sticky;
+  top: 0;
+  height: 100vh;
+  overflow-y: auto;
+  padding: 1.5rem 1rem;
+  background: var(--nd-sidebar-bg);
+  border-right: 1px solid var(--nd-border);
+  font-size: 0.875rem;
+  scrollbar-width: thin;
+  scrollbar-color: var(--nd-border) transparent;
+}
+
+.docs-sidebar::-webkit-scrollbar {
+  width: 4px;
+}
+
+.docs-sidebar::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+.docs-sidebar::-webkit-scrollbar-thumb {
+  background: var(--nd-border);
+  border-radius: 2px;
+}
+
+.docs-sidebar-logo {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  font-size: 1rem;
+  font-weight: 600;
+  padding-bottom: 1.25rem;
+  margin-bottom: 1rem;
+  border-bottom: 1px solid var(--nd-border);
+}
+
+.docs-sidebar-logo img,
+.docs-sidebar-logo svg {
+  width: 1.5rem;
+  height: 1.5rem;
+}
+
+.docs-sidebar nav {
+  display: flex;
+  flex-direction: column;
+  gap: 0.125rem;
+}
+
+.docs-sidebar-section {
+  margin-top: 1rem;
+}
+
+.docs-sidebar-section > summary,
+.docs-sidebar-section-title {
+  font-size: 0.875rem;
+  font-weight: 600;
+  color: var(--nd-fg);
+  padding: 0.375rem 0.5rem;
+  cursor: pointer;
+  list-style: none;
+  user-select: none;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+
+.docs-sidebar-section > summary::-webkit-details-marker {
+  display: none;
+}
+
+.docs-sidebar-section > summary::after {
+  content: '';
+  width: 0.375rem;
+  height: 0.375rem;
+  border-right: 1.5px solid var(--nd-muted);
+  border-bottom: 1.5px solid var(--nd-muted);
+  transform: rotate(-45deg);
+  transition: transform 0.15s ease;
+}
+
+.docs-sidebar-section[open] > summary::after {
+  transform: rotate(45deg);
+}
+
+.docs-sidebar-section-items {
+  display: flex;
+  flex-direction: column;
+  gap: 0.125rem;
+  padding-left: 0.5rem;
+  margin-top: 0.125rem;
+}
+
+.docs-sidebar-link {
+  display: block;
+  padding: 0.375rem 0.75rem;
+  border-radius: var(--nd-radius);
+  color: var(--nd-muted);
+  font-weight: 400;
+  transition: color 0.15s ease, background 0.15s ease;
+}
+
+.docs-sidebar-link:hover {
+  color: var(--nd-fg);
+  background: var(--nd-card-bg);
+}
+
+.docs-sidebar-link[aria-current="page"] {
+  color: var(--nd-fg);
+  background: var(--nd-card-hover);
+  font-weight: 500;
+}
+
+/* Content area */
+.docs-main {
+  padding: 2.5rem 3rem;
+  max-width: var(--nd-content-max);
+  width: 100%;
+  min-width: 0;
+}
+
+.docs-main-header {
+  margin-bottom: 2rem;
+}
+
+.docs-main-header h1 {
+  font-size: 1.875rem;
+  font-weight: 700;
+  line-height: 1.2;
+  letter-spacing: -0.02em;
+}
+
+.docs-main-header p {
+  margin-top: 0.5rem;
+  color: var(--nd-muted);
+  font-size: 1rem;
+}
+
+/* TOC */
+.docs-toc {
+  position: sticky;
+  top: 0;
+  height: 100vh;
+  overflow-y: auto;
+  padding: 2.5rem 1rem 2.5rem 0;
+  font-size: 0.875rem;
+  scrollbar-width: thin;
+  scrollbar-color: var(--nd-border) transparent;
+}
+
+.docs-toc::-webkit-scrollbar {
+  width: 4px;
+}
+
+.docs-toc::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+.docs-toc::-webkit-scrollbar-thumb {
+  background: var(--nd-border);
+  border-radius: 2px;
+}
+
+.docs-toc-title {
+  font-size: 0.875rem;
+  font-weight: 600;
+  margin-bottom: 0.75rem;
+  color: var(--nd-fg);
+}
+
+.docs-toc nav {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+  border-left: 1px solid var(--nd-border);
+  padding-left: 0.75rem;
+}
+
+.docs-toc-link {
+  display: block;
+  padding: 0.25rem 0;
+  color: var(--nd-muted);
+  font-weight: 400;
+  transition: color 0.15s ease;
+}
+
+.docs-toc-link:hover {
+  color: var(--nd-fg);
+}
+
+.docs-toc-link[aria-current="true"] {
+  color: var(--nd-accent);
+  font-weight: 500;
+}
+
+.docs-toc-link--h3 {
+  padding-left: 0.75rem;
+}
+
+/* Breadcrumbs */
+.docs-breadcrumbs {
+  display: flex;
+  align-items: center;
+  gap: 0.375rem;
+  font-size: 0.875rem;
+  color: var(--nd-muted);
+  margin-bottom: 1rem;
+}
+
+.docs-breadcrumbs a {
+  color: var(--nd-muted);
+  transition: color 0.15s ease;
+}
+
+.docs-breadcrumbs a:hover {
+  color: var(--nd-fg);
+}
+
+.docs-breadcrumbs-sep {
+  color: var(--nd-border);
+  user-select: none;
+}
+
+.docs-breadcrumbs-current {
+  color: var(--nd-fg);
+  font-weight: 500;
+}
+
+/* Footer pagination */
+.docs-footer {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 1rem;
+  margin-top: 3rem;
+  padding-top: 2rem;
+  border-top: 1px solid var(--nd-border);
+}
+
+.docs-footer-link {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+  padding: 1rem;
+  border: 1px solid var(--nd-border);
+  border-radius: var(--nd-radius);
+  transition: background 0.15s ease, border-color 0.15s ease;
+}
+
+.docs-footer-link:hover {
+  background: var(--nd-card-bg);
+  border-color: var(--nd-muted);
+}
+
+.docs-footer-link--next {
+  text-align: right;
+  grid-column: 2;
+}
+
+.docs-footer-label {
+  font-size: 0.875rem;
+  color: var(--nd-muted);
+  font-weight: 400;
+}
+
+.docs-footer-title {
+  font-size: 1rem;
+  font-weight: 500;
+  color: var(--nd-fg);
+}
+
+/* Mobile sidebar toggle */
+.docs-mobile-toggle {
+  display: none;
+  position: fixed;
+  bottom: 1.25rem;
+  right: 1.25rem;
+  z-index: 50;
+  width: 3rem;
+  height: 3rem;
+  border-radius: var(--nd-radius);
+  border: 1px solid var(--nd-border);
+  background: var(--nd-bg);
+  color: var(--nd-fg);
+  cursor: pointer;
+  align-items: center;
+  justify-content: center;
+}
+
+.docs-mobile-toggle svg {
+  width: 1.25rem;
+  height: 1.25rem;
+}
+
+.docs-sidebar-overlay {
+  display: none;
+  position: fixed;
+  inset: 0;
+  z-index: 39;
+  background: hsla(0, 0%, 0%, 0.5);
+}
+
+/* Responsive */
+@media (max-width: 1280px) {
+  .docs-layout {
+    grid-template-columns: var(--nd-sidebar-width) minmax(0, 1fr);
+  }
+
+  .docs-toc {
+    display: none;
+  }
+}
+
+@media (max-width: 768px) {
+  .docs-layout {
+    grid-template-columns: 1fr;
+  }
+
+  .docs-sidebar {
+    position: fixed;
+    top: 0;
+    left: 0;
+    z-index: 40;
+    width: var(--nd-sidebar-width);
+    transform: translateX(-100%);
+    transition: transform 0.2s ease;
+  }
+
+  .docs-sidebar.is-open {
+    transform: translateX(0);
+  }
+
+  .docs-sidebar.is-open ~ .docs-sidebar-overlay {
+    display: block;
+  }
+
+  .docs-mobile-toggle {
+    display: flex;
+  }
+
+  .docs-main {
+    padding: 1.5rem 1rem;
+  }
+}

package/templates/docs/src/styles/prose.css

@@ -0,0 +1,224 @@
+/* Prose — rendered markdown typography */
+
+.prose {
+  font-size: 1rem;
+  line-height: 1.75;
+  color: var(--nd-fg);
+}
+
+.prose > * + * {
+  margin-top: 1.25rem;
+}
+
+/* Headings */
+.prose h1 {
+  font-size: 1.875rem;
+  font-weight: 700;
+  line-height: 1.2;
+  letter-spacing: -0.02em;
+  margin-top: 0;
+}
+
+.prose h2 {
+  font-size: 1.5rem;
+  font-weight: 600;
+  line-height: 1.3;
+  letter-spacing: -0.01em;
+  margin-top: 2.5rem;
+  padding-bottom: 0.5rem;
+  border-bottom: 1px solid var(--nd-border);
+}
+
+.prose h3 {
+  font-size: 1.25rem;
+  font-weight: 600;
+  line-height: 1.4;
+  margin-top: 2rem;
+}
+
+.prose h2 + h3 {
+  margin-top: 1rem;
+}
+
+/* Heading anchors */
+.prose h2 > a,
+.prose h3 > a {
+  color: inherit;
+  text-decoration: none;
+}
+
+.prose h2 > a:hover::after,
+.prose h3 > a:hover::after {
+  content: ' #';
+  color: var(--nd-muted);
+  font-weight: 400;
+}
+
+/* Paragraphs */
+.prose p {
+  margin-top: 1.25rem;
+}
+
+.prose h1 + p,
+.prose h2 + p,
+.prose h3 + p {
+  margin-top: 0.5rem;
+}
+
+/* Links */
+.prose a {
+  color: var(--nd-accent);
+  text-decoration: none;
+  font-weight: 500;
+  transition: text-decoration 0.15s ease;
+}
+
+.prose a:hover {
+  text-decoration: underline;
+  text-underline-offset: 2px;
+}
+
+/* Bold and italic */
+.prose strong {
+  font-weight: 600;
+  color: var(--nd-fg);
+}
+
+.prose em {
+  font-style: italic;
+}
+
+/* Lists */
+.prose ul,
+.prose ol {
+  padding-left: 1.5rem;
+  margin-top: 1rem;
+}
+
+.prose ul {
+  list-style-type: disc;
+}
+
+.prose ol {
+  list-style-type: decimal;
+}
+
+.prose li {
+  margin-top: 0.375rem;
+  padding-left: 0.375rem;
+}
+
+.prose li > ul,
+.prose li > ol {
+  margin-top: 0.375rem;
+}
+
+.prose li::marker {
+  color: var(--nd-muted);
+}
+
+/* Blockquotes */
+.prose blockquote {
+  border-left: 3px solid var(--nd-accent);
+  padding: 0.5rem 1rem;
+  margin-left: 0;
+  margin-right: 0;
+  color: var(--nd-muted);
+  font-style: italic;
+  background: var(--nd-card-bg);
+  border-radius: 0 var(--nd-radius) var(--nd-radius) 0;
+}
+
+.prose blockquote p {
+  margin-top: 0;
+}
+
+.prose blockquote p + p {
+  margin-top: 0.75rem;
+}
+
+/* Inline code */
+.prose :not(pre) > code {
+  font-family: 'JetBrains Mono', ui-monospace, monospace;
+  font-size: 0.875em;
+  font-weight: 400;
+  background: var(--nd-code-bg);
+  padding: 0.15em 0.35em;
+  border-radius: 0.25rem;
+  border: 1px solid var(--nd-border);
+}
+
+/* Tables */
+.prose table {
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 0.875rem;
+  margin-top: 1.5rem;
+}
+
+.prose thead th {
+  text-align: left;
+  font-weight: 600;
+  padding: 0.625rem 0.75rem;
+  border-bottom: 2px solid var(--nd-border);
+  color: var(--nd-fg);
+}
+
+.prose tbody td {
+  padding: 0.625rem 0.75rem;
+  border-bottom: 1px solid var(--nd-border);
+}
+
+.prose tbody tr:nth-child(even) {
+  background: var(--nd-card-bg);
+}
+
+.prose tbody tr:hover {
+  background: var(--nd-card-hover);
+}
+
+/* Horizontal rules */
+.prose hr {
+  border: none;
+  border-top: 1px solid var(--nd-border);
+  margin: 2.5rem 0;
+}
+
+/* Images */
+.prose img {
+  max-width: 100%;
+  height: auto;
+  border-radius: var(--nd-radius);
+  border: 1px solid var(--nd-border);
+  margin-top: 1.5rem;
+}
+
+.prose img + em {
+  display: block;
+  text-align: center;
+  font-size: 0.875rem;
+  color: var(--nd-muted);
+  margin-top: 0.5rem;
+}
+
+/* Definition lists */
+.prose dt {
+  font-weight: 600;
+  margin-top: 1rem;
+}
+
+.prose dd {
+  padding-left: 1rem;
+  color: var(--nd-muted);
+}
+
+/* Keyboard input */
+.prose kbd {
+  font-family: 'Inter', system-ui, sans-serif;
+  font-size: 0.75rem;
+  padding: 0.15em 0.4em;
+  border: 1px solid var(--nd-border);
+  border-radius: 0.25rem;
+  background: var(--nd-card-bg);
+  box-shadow: 0 1px 0 var(--nd-border);
+}