@webstir-io/webstir 0.1.0

package/assets/templates/ssg/src/frontend/pages/docs/index.css

@@ -0,0 +1,505 @@
+/* Docs Styles (shared by /docs and Markdown docs pages) */
+
+@layer overrides {
+.docs-layout {
+  --ws-docs-layout-gap: 44px;
+  --ws-docs-layout-gap-sm: 24px;
+  --ws-docs-layout-pad-bottom: 112px;
+  --ws-docs-layout-pad-bottom-sm: 96px;
+  --ws-docs-sidebar-pad-top: 24px;
+  --ws-docs-toc-pad-top: 32px;
+  --ws-docs-ui-gap: 4px;
+  --ws-docs-ui-gap-lg: 8px;
+  --ws-docs-ui-gap-tight: 10px;
+  --ws-docs-ui-pad: 8px 10px;
+  --ws-docs-tree-indent: 14px;
+  --ws-docs-surface-padding: 14px 16px;
+
+  padding: var(--ws-sticky-gap, 16px) 0 var(--ws-docs-layout-pad-bottom, 112px);
+  --ws-container: var(--ws-shell-container);
+}
+
+.docs-layout__inner {
+  display: grid;
+  grid-template-columns: var(--ws-docs-sidebar) 1fr;
+  gap: var(--ws-docs-layout-gap, 44px);
+  align-items: start;
+}
+
+.docs-layout.has-toc .docs-layout__inner {
+  grid-template-columns: var(--ws-docs-sidebar) minmax(0, 1fr) var(--ws-docs-toc);
+}
+
+.docs-sidebar {
+  position: sticky;
+  top: calc(var(--ws-header-sticky-offset, 0px) + var(--ws-sticky-gap, 16px));
+  align-self: start;
+  padding-top: var(--ws-docs-sidebar-pad-top, 24px);
+}
+
+@media (max-width: 40rem) {
+  .docs-layout {
+    padding: var(--ws-sticky-gap, 16px) 0 var(--ws-docs-layout-pad-bottom-sm, 96px);
+  }
+
+  .docs-layout__inner {
+    gap: var(--ws-docs-layout-gap-sm, 24px);
+  }
+
+  .docs-sidebar {
+    display: none;
+  }
+}
+
+.docs-sidebar__header {
+  margin-top: var(--ws-docs-ui-gap-lg, 8px);
+  margin-bottom: var(--ws-docs-ui-gap-tight, 10px);
+}
+
+.docs-sidebar__title {
+  font-weight: 800;
+  color: var(--ws-fg);
+  text-decoration: none;
+}
+
+.docs-nav {
+  border-top: 1px solid var(--ws-border);
+  padding-top: calc(var(--ws-docs-ui-gap, 4px) + var(--ws-docs-ui-gap-lg, 8px));
+}
+
+.docs-links {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: grid;
+  gap: var(--ws-docs-ui-gap, 4px);
+}
+
+.docs-links__section {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: grid;
+  gap: var(--ws-docs-ui-gap, 4px);
+}
+
+.docs-tree__toggle {
+  appearance: none;
+  width: 100%;
+  display: flex;
+  align-items: center;
+  gap: var(--ws-docs-ui-gap-lg, 8px);
+  padding: var(--ws-docs-ui-pad, 8px 10px);
+  border-radius: var(--ws-radius-1);
+  border: 0;
+  background: transparent;
+  color: var(--ws-fg);
+  font-weight: 700;
+  cursor: pointer;
+  text-align: left;
+}
+
+.docs-tree__toggle:hover {
+  background: rgba(17, 24, 39, 0.04);
+}
+
+.docs-tree__caret {
+  width: 0;
+  height: 0;
+  border-left: 5px solid rgba(229, 231, 235, 0.7);
+  border-top: 4px solid transparent;
+  border-bottom: 4px solid transparent;
+  transform: rotate(90deg);
+  transition: transform 120ms ease;
+}
+
+.docs-tree__toggle[aria-expanded="false"] .docs-tree__caret {
+  transform: rotate(0deg);
+}
+
+.docs-tree__children {
+  list-style: none;
+  margin: var(--ws-docs-ui-gap, 4px) 0 var(--ws-docs-ui-gap-tight, 10px) var(--ws-docs-tree-indent, 14px);
+  padding: 0 0 0 var(--ws-docs-ui-gap-tight, 10px);
+  border-left: 1px solid rgba(229, 231, 235, 0.16);
+  display: grid;
+  gap: var(--ws-docs-ui-gap, 4px);
+}
+
+.docs-tree__children[hidden] {
+  display: none;
+}
+
+.docs-links a {
+  display: block;
+  padding: var(--ws-docs-ui-pad, 8px 10px);
+  border-radius: var(--ws-radius-1);
+  color: var(--ws-fg);
+  text-decoration: none;
+  font-weight: 600;
+}
+
+.docs-links a:hover {
+  background: rgba(17, 24, 39, 0.04);
+  text-decoration: none;
+}
+
+.docs-links a[aria-current="page"] {
+  background: rgba(37, 99, 235, 0.10);
+  color: var(--ws-fg);
+}
+
+.docs-breadcrumb {
+  margin: 0 0 calc(var(--ws-docs-ui-gap-lg, 8px) * 2);
+}
+
+.docs-breadcrumb__list {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: var(--ws-docs-ui-gap, 4px);
+  color: var(--ws-fg);
+  font-size: 0.82rem;
+  font-weight: 600;
+}
+
+.docs-breadcrumb__list li {
+  display: inline-flex;
+  align-items: center;
+  gap: calc(var(--ws-docs-ui-gap, 4px) + 2px);
+}
+
+.docs-breadcrumb__list li + li::before {
+  content: '›';
+  margin-inline: 2px;
+  color: rgba(148, 163, 184, 0.8);
+}
+
+.docs-breadcrumb__item {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--ws-docs-ui-gap-lg, 8px);
+  color: inherit;
+  text-decoration: none;
+  line-height: 1;
+}
+
+.docs-breadcrumb__label {
+  display: inline-flex;
+  align-items: center;
+  padding: 0.35rem 0.7rem;
+  border-radius: 999px;
+  border: 1px solid transparent;
+}
+
+.docs-breadcrumb__item:hover {
+  color: var(--ws-fg);
+  text-decoration: none;
+}
+
+.docs-breadcrumb__label--current {
+  color: var(--ws-fg);
+  background: rgba(17, 24, 39, 0.06);
+  border-color: var(--ws-border);
+}
+
+.docs-breadcrumb__icon {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.docs-breadcrumb__icon svg {
+  display: block;
+}
+
+.docs-breadcrumb__icon {
+  color: var(--ws-fg);
+}
+
+.docs-section {
+  margin-top: 12px;
+}
+
+.docs-section:first-child {
+  margin-top: 0;
+}
+
+.docs-section__title {
+  color: var(--ws-muted);
+  font-size: 0.9rem;
+  font-weight: 700;
+  letter-spacing: 0.02em;
+  text-transform: uppercase;
+  margin: 8px 0;
+}
+
+.docs-main {
+  padding-top: 16px;
+  width: min(100%, 92ch);
+  margin-inline: auto;
+  min-width: 0;
+}
+
+@media (max-width: 40rem) {
+  .docs-main {
+    padding-top: 8px;
+    width: 100%;
+    max-width: none;
+    margin-inline: 0;
+  }
+}
+
+.docs-toc {
+  position: sticky;
+  top: calc(var(--ws-header-sticky-offset, 0px) + var(--ws-sticky-gap, 16px));
+  align-self: start;
+  padding-top: var(--ws-docs-toc-pad-top, 32px);
+}
+
+@media (max-width: 68.75rem) {
+  .docs-toc {
+    display: none;
+  }
+
+  .docs-layout.has-toc .docs-layout__inner {
+    grid-template-columns: var(--ws-docs-sidebar) minmax(0, 1fr);
+  }
+}
+
+@media (max-width: 53.75rem), (max-width: 860px) {
+  .docs-layout__inner,
+  .docs-layout.has-toc .docs-layout__inner {
+    grid-template-columns: 1fr;
+  }
+
+  .docs-sidebar {
+    display: none;
+  }
+}
+
+.docs-toc__title {
+  color: var(--ws-muted);
+  font-size: 0.9rem;
+  font-weight: 700;
+  letter-spacing: 0.02em;
+  text-transform: uppercase;
+  margin: var(--ws-docs-ui-gap-lg, 8px) 0 var(--ws-docs-ui-gap-tight, 10px);
+}
+
+.docs-toc__links {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: grid;
+  gap: 6px;
+}
+
+.docs-toc__links a {
+  color: var(--ws-muted);
+  text-decoration: none;
+  font-weight: 600;
+  font-size: 0.95rem;
+  line-height: 1.3;
+}
+
+.docs-toc__links a:hover {
+  color: var(--ws-fg);
+  text-decoration: none;
+}
+
+.docs-toc__links a[aria-current="true"] {
+  color: var(--ws-fg);
+}
+
+.docs-toc__links .docs-toc__sub {
+  padding-left: calc(var(--ws-docs-ui-gap, 4px) + var(--ws-docs-ui-gap-lg, 8px));
+}
+
+.docs-hero {
+  margin-bottom: 28px;
+}
+
+.docs-hero h1 {
+  font-size: 2.25rem;
+  letter-spacing: -0.02em;
+  margin: 0 0 calc(var(--ws-docs-ui-gap, 4px) + var(--ws-docs-ui-gap-lg, 8px));
+}
+
+.docs-lead {
+  color: var(--ws-muted);
+  font-size: 1.1rem;
+  margin: 0;
+}
+
+.docs-cards {
+  display: grid;
+  grid-template-columns: repeat(1, minmax(0, 1fr));
+  gap: calc(var(--ws-docs-ui-gap, 4px) + var(--ws-docs-ui-gap-lg, 8px));
+  margin: 22px 0 36px;
+}
+
+.docs-card {
+  border: 1px solid var(--ws-border);
+  border-radius: var(--ws-radius-2);
+  padding: var(--ws-docs-surface-padding, 14px 16px);
+  text-decoration: none;
+  color: var(--ws-fg);
+  background: #ffffff;
+}
+
+.docs-card:hover {
+  text-decoration: none;
+  border-color: rgba(37, 99, 235, 0.4);
+}
+
+.docs-card__title {
+  font-weight: 800;
+  margin-bottom: 6px;
+}
+
+.docs-card__body {
+  color: var(--ws-muted);
+}
+
+/* Markdown docs content */
+.docs-article h1 {
+  margin-bottom: 1.25rem;
+  font-size: 2.25rem;
+  letter-spacing: -0.02em;
+}
+
+.docs-article p {
+  margin: 0 0 1.4rem 0;
+}
+
+.docs-article h2 {
+  margin-top: 3.25rem;
+  margin-bottom: 0.75rem;
+  font-size: 1.5rem;
+}
+
+.docs-article h3 {
+  margin-top: 2.25rem;
+  margin-bottom: 0.6rem;
+  font-size: 1.2rem;
+}
+
+.docs-article ul,
+.docs-article ol {
+  margin: 0 0 1.25rem 0;
+  padding-left: 22px;
+}
+
+.docs-article li {
+  margin: 0.6rem 0;
+}
+
+.docs-article pre {
+  margin: 1rem 0 1.5rem;
+}
+
+.docs-article pre code.hljs {
+  display: block;
+  padding: var(--ws-docs-surface-padding, 14px 16px);
+  border-radius: var(--ws-radius-3);
+  border: 1px solid var(--ws-border);
+  background: rgba(17, 24, 39, 0.04);
+  overflow-x: auto;
+  font-size: 0.95rem;
+  line-height: 1.55;
+}
+
+.docs-article :not(pre) > code {
+  padding: 0.15em 0.4em;
+  border-radius: var(--ws-radius-1);
+  border: 1px solid rgba(229, 231, 235, 0.18);
+  background: rgba(17, 24, 39, 0.04);
+  overflow-wrap: anywhere;
+  word-break: break-word;
+}
+
+.hljs-comment,
+.hljs-quote {
+  color: var(--ws-muted);
+  font-style: italic;
+}
+
+.hljs-keyword,
+.hljs-selector-tag,
+.hljs-literal,
+.hljs-built_in {
+  color: #2563eb;
+}
+
+.hljs-string,
+.hljs-attr,
+.hljs-symbol {
+  color: #059669;
+}
+
+.hljs-number,
+.hljs-meta {
+  color: #b45309;
+}
+
+.hljs-title,
+.hljs-section,
+.hljs-function {
+  color: #7c3aed;
+}
+
+.hljs-type {
+  color: #0f766e;
+}
+
+.docs-callout {
+  margin: 1.2rem 0 1.6rem;
+  padding: var(--ws-docs-surface-padding, 14px 16px);
+  border-radius: var(--ws-radius-3);
+  border: 1px solid var(--ws-border);
+  border-left-width: 4px;
+  background: rgba(17, 24, 39, 0.03);
+}
+
+.docs-callout__title {
+  font-weight: 800;
+  margin-bottom: var(--ws-docs-ui-gap-lg, 8px);
+}
+
+.docs-callout__body > :last-child {
+  margin-bottom: 0;
+}
+
+.docs-callout__body p {
+  margin-bottom: 0.9rem;
+}
+
+.docs-callout__body ul,
+.docs-callout__body ol {
+  margin-bottom: 0.9rem;
+}
+
+.docs-callout--note {
+  border-left-color: rgba(37, 99, 235, 0.7);
+}
+
+.docs-callout--tip {
+  border-left-color: rgba(5, 150, 105, 0.7);
+}
+
+.docs-callout--info {
+  border-left-color: rgba(14, 116, 144, 0.7);
+}
+
+.docs-callout--warning {
+  border-left-color: rgba(180, 83, 9, 0.75);
+}
+
+.docs-callout--danger {
+  border-left-color: rgba(220, 38, 38, 0.7);
+}
+}

package/assets/templates/ssg/src/frontend/pages/docs/index.html

@@ -0,0 +1,52 @@
+<head>
+  <title>Docs</title>
+  <link rel="stylesheet" href="index.css" />
+</head>
+<body>
+  <main>
+    <section class="docs-layout" data-scope="docs">
+      <div class="ws-container docs-layout__inner">
+        <aside class="docs-sidebar" aria-label="Docs navigation">
+          <div class="docs-sidebar__header">
+            <a class="docs-sidebar__title" href="/docs/">Docs</a>
+          </div>
+          <nav class="docs-nav" aria-label="Docs pages">
+            <ul id="docs-links" class="docs-links">
+              <li><a href="/docs/content-pipeline/">Content pipeline</a></li>
+              <li><a href="/docs/css-playbook/">CSS Playbook</a></li>
+            </ul>
+          </nav>
+        </aside>
+
+        <div class="docs-main">
+          <header class="docs-hero">
+            <h1>Documentation</h1>
+            <p class="docs-lead">
+              Drop Markdown files into <code>src/frontend/content/</code> and Webstir turns them into real pages under
+              <code>/docs/</code>.
+            </p>
+          </header>
+
+          <section class="docs-cards">
+            <a class="docs-card" href="/docs/content-pipeline/">
+              <div class="docs-card__title">Start here</div>
+              <div class="docs-card__body">How the content pipeline works.</div>
+            </a>
+            <a class="docs-card" href="/docs/css-playbook/">
+              <div class="docs-card__title">CSS Playbook</div>
+              <div class="docs-card__body">Minimal tokens, layout, and components.</div>
+            </a>
+          </section>
+        </div>
+
+        <aside class="docs-toc" aria-label="On this page" hidden>
+          <div class="docs-toc__title">On this page</div>
+          <nav class="docs-toc__nav">
+            <ul id="docs-toc" class="docs-toc__links"></ul>
+          </nav>
+        </aside>
+      </div>
+    </section>
+  </main>
+  <script type="module" src="index.js"></script>
+</body>