@erinjs/core 1.0.0

package/core/apps/docs/src/pages/ApiReferenceLayout.vue

@@ -0,0 +1,175 @@
+<template>
+  <div class="api-layout">
+    <button
+      type="button"
+      class="sidebar-toggle"
+      aria-label="Toggle navigation menu"
+      @click="sidebarOpen = !sidebarOpen">
+      <span class="toggle-icon">{{ sidebarOpen ? '✕' : '☰' }}</span>
+    </button>
+    <div
+      v-if="sidebarOpen"
+      class="sidebar-backdrop"
+      aria-hidden="true"
+      @click="sidebarOpen = false" />
+    <aside class="api-sidebar sidebar-base" :class="{ 'is-open': sidebarOpen }">
+      <h3 class="sidebar-title">REST API</h3>
+      <CommunityCallout variant="sidebar" />
+      <router-link :to="versionedPath('/guides')" class="api-guides-link">Guides →</router-link>
+      <nav class="api-nav">
+        <a
+          v-for="cat in API_CATEGORIES"
+          :key="cat"
+          :href="`#${cat}`"
+          class="sidebar-link"
+          @click="sidebarOpen = false">
+          {{ API_CATEGORY_LABELS[cat] }}
+        </a>
+      </nav>
+    </aside>
+    <main class="api-content">
+      <div class="api-content-scroll">
+        <router-view />
+      </div>
+      <Footer class="content-footer" />
+    </main>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { ref, watch } from 'vue';
+import { useRoute } from 'vue-router';
+import Footer from '../components/Footer.vue';
+import CommunityCallout from '../components/CommunityCallout.vue';
+import { API_CATEGORIES, API_CATEGORY_LABELS } from '../data/apiEndpoints';
+import { useVersionedPath } from '../composables/useVersionedPath';
+
+const route = useRoute();
+const { path: versionedPath } = useVersionedPath();
+const sidebarOpen = ref(false);
+
+watch(
+  () => route.path,
+  () => {
+    sidebarOpen.value = false;
+  },
+);
+</script>
+
+<style scoped>
+.api-layout {
+  display: flex;
+  flex: 1;
+  min-height: 0;
+  overflow: hidden;
+}
+
+.api-sidebar {
+  /* Shared from .sidebar-base */
+}
+
+.api-guides-link {
+  display: block;
+  margin: 0 var(--sidebar-padding-x) 1rem;
+  padding: 0.5rem 0.75rem;
+  font-size: 0.85rem;
+  font-weight: 600;
+  color: var(--accent);
+  text-decoration: none;
+  background: rgba(99, 179, 237, 0.1);
+  border: 1px solid rgba(99, 179, 237, 0.25);
+  border-radius: var(--radius-sm);
+  transition:
+    background 0.15s,
+    border-color 0.15s;
+}
+
+.api-guides-link:hover {
+  background: rgba(99, 179, 237, 0.18);
+  border-color: var(--accent);
+}
+
+.api-nav {
+  display: flex;
+  flex-direction: column;
+}
+
+.api-sidebar .sidebar-link {
+  padding: 0.5rem var(--sidebar-padding-x);
+  font-size: 0.9rem;
+  color: var(--text-secondary);
+  text-decoration: none;
+  border-left: 2px solid transparent;
+  margin-left: 2px;
+  transition:
+    color 0.15s,
+    background 0.15s,
+    border-color 0.15s;
+}
+
+.api-sidebar .sidebar-link:hover {
+  color: var(--accent);
+  background: var(--bg-hover);
+}
+
+.api-content {
+  flex: 1;
+  min-width: 0;
+  overflow-y: auto;
+  display: flex;
+  flex-direction: column;
+}
+
+.api-content-scroll {
+  flex: 1;
+  padding: 2rem 2.5rem;
+  max-width: 1280px;
+  min-width: 0;
+}
+
+.content-footer {
+  flex-shrink: 0;
+}
+
+.sidebar-toggle {
+  display: none;
+  position: fixed;
+  bottom: 1.25rem;
+  left: 1.25rem;
+  z-index: 99;
+  width: 48px;
+  height: 48px;
+  padding: 0;
+  background: var(--accent);
+  color: var(--bg-primary);
+  border: none;
+  border-radius: 50%;
+  cursor: pointer;
+  font-size: 1.25rem;
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.3);
+  transition:
+    transform 0.2s,
+    background 0.2s;
+}
+
+.sidebar-toggle:hover {
+  background: var(--accent-hover);
+  transform: scale(1.05);
+}
+
+.sidebar-backdrop {
+  display: none;
+  position: fixed;
+  inset: 0;
+  z-index: 99;
+  background: rgba(0, 0, 0, 0.5);
+  backdrop-filter: blur(2px);
+}
+
+@media (max-width: 900px) {
+  .sidebar-toggle,
+  .sidebar-backdrop {
+    display: block;
+  }
+}
+</style>

package/core/apps/docs/src/pages/ApiReferencePage.vue

@@ -0,0 +1,128 @@
+<template>
+  <div class="api-reference">
+    <header class="api-hero">
+      <h1 class="api-title">REST API Reference</h1>
+      <p class="api-lead">Bot and webhook endpoints for the Fluxer API.</p>
+      <div class="api-quick-info">
+        <div class="api-quick-item">
+          <span class="api-quick-label">Base path</span>
+          <code class="api-quick-value">/v1</code>
+        </div>
+        <div class="api-quick-item">
+          <span class="api-quick-label">Auth (bot)</span>
+          <code class="api-quick-value">Authorization: Bot &lt;token&gt;</code>
+        </div>
+        <div class="api-quick-links">
+          <router-link :to="versionedPath('/guides')" class="api-quick-link">Guides →</router-link>
+          <router-link :to="versionedPath('/guides/basic-bot')" class="api-quick-link"
+            >Basic bot</router-link
+          >
+        </div>
+      </div>
+    </header>
+
+    <ApiCategorySection
+      v-for="cat in API_CATEGORIES"
+      :key="cat"
+      :id="cat"
+      :title="API_CATEGORY_LABELS[cat]"
+      :endpoints="endpointsByCategory[cat] ?? []" />
+  </div>
+</template>
+
+<script setup lang="ts">
+import { computed } from 'vue';
+import ApiCategorySection from '../components/ApiCategorySection.vue';
+import { API_CATEGORIES, API_CATEGORY_LABELS, getEndpointsByCategory } from '../data/apiEndpoints';
+import { useVersionedPath } from '../composables/useVersionedPath';
+
+const { path: versionedPath } = useVersionedPath();
+const endpointsByCategory = computed(() => getEndpointsByCategory());
+</script>
+
+<style scoped>
+.api-reference {
+  display: flex;
+  flex-direction: column;
+  gap: 3rem;
+}
+
+.api-hero {
+  margin-bottom: 0.5rem;
+}
+
+.api-title {
+  font-size: 2rem;
+  font-weight: 700;
+  color: var(--text-primary);
+  margin: 0 0 0.5rem;
+  letter-spacing: -0.02em;
+}
+
+.api-lead {
+  font-size: 1rem;
+  color: var(--text-secondary);
+  line-height: 1.6;
+  margin: 0 0 1.5rem;
+}
+
+.api-quick-info {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 1rem 1.5rem;
+  padding: 1rem 1.25rem;
+  background: var(--bg-secondary);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+}
+
+.api-quick-item {
+  display: flex;
+  align-items: baseline;
+  gap: 0.5rem;
+}
+
+.api-quick-label {
+  font-size: 0.75rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: var(--text-muted);
+}
+
+.api-quick-value {
+  font-family: 'JetBrains Mono', ui-monospace, monospace;
+  font-size: 0.85rem;
+  padding: 0.2em 0.5em;
+  background: var(--bg-tertiary);
+  border-radius: var(--radius-sm);
+  color: var(--accent);
+  border: 1px solid var(--border);
+}
+
+.api-quick-links {
+  margin-left: auto;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.75rem 1rem;
+}
+
+@media (max-width: 640px) {
+  .api-quick-links {
+    margin-left: 0;
+    width: 100%;
+  }
+}
+
+.api-quick-link {
+  font-size: 0.9rem;
+  font-weight: 500;
+  color: var(--accent);
+  text-decoration: none;
+}
+
+.api-quick-link:hover {
+  text-decoration: underline;
+}
+</style>

package/core/apps/docs/src/pages/Changelog.vue

@@ -0,0 +1,288 @@
+<template>
+  <div class="changelog-page">
+    <div class="changelog-hero">
+      <h1>Changelog</h1>
+      <p class="lead">Release history and changes for erin.js SDK.</p>
+      <div class="version-filter" role="group" aria-label="Filter by version">
+        <button
+          type="button"
+          class="filter-pill"
+          :class="{ active: selectedVersion === null }"
+          @click="selectedVersion = null">
+          All versions
+        </button>
+        <button
+          v-for="v in versions"
+          :key="v"
+          type="button"
+          class="filter-pill"
+          :class="{ active: selectedVersion === v }"
+          @click="selectedVersion = v">
+          v{{ v }}
+        </button>
+      </div>
+    </div>
+    <div class="changelog-entries">
+      <article
+        v-for="entry in filteredChangelog"
+        :id="`v${entry.version}`"
+        :key="entry.version"
+        class="changelog-entry">
+        <header class="entry-header">
+          <h2 class="entry-version">
+            v{{ entry.version }}
+            <button
+              type="button"
+              class="copy-link-btn"
+              :aria-label="`Copy link to v${entry.version}`"
+              @click="copyLink(`#v${entry.version}`)">
+              #
+            </button>
+          </h2>
+          <time class="entry-date">{{ formatDate(entry.date) }}</time>
+        </header>
+        <div
+          v-for="section in entry.sections"
+          :id="`v${entry.version}-${sectionSlug(section.title)}`"
+          :key="section.title"
+          class="section">
+          <h3 class="section-title">
+            {{ section.title }}
+            <button
+              type="button"
+              class="copy-link-btn"
+              :aria-label="`Copy link to ${section.title}`"
+              @click="copyLink(`#v${entry.version}-${sectionSlug(section.title)}`)">
+              #
+            </button>
+          </h3>
+          <ul class="section-items">
+            <li v-for="(item, i) in section.items" :key="i" class="item">
+              {{ item }}
+            </li>
+          </ul>
+        </div>
+      </article>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { ref, computed, watch } from 'vue';
+import { useRoute, useRouter } from 'vue-router';
+import { changelogEntries } from '../data/changelog';
+
+const route = useRoute();
+const router = useRouter();
+
+const versions = changelogEntries.map((e) => e.version);
+
+// Sync with ?version= query param
+const initVersion = (() => {
+  const v = route.query.version as string | undefined;
+  return v && versions.includes(v) ? v : null;
+})();
+const selectedVersion = ref<string | null>(initVersion);
+
+watch(
+  () => route.query.version as string | undefined,
+  (v) => {
+    selectedVersion.value = v && versions.includes(v) ? v : null;
+  },
+  { immediate: true },
+);
+
+watch(selectedVersion, (v) => {
+  const base = { ...route.query } as Record<string, string>;
+  const next = v
+    ? { ...base, version: v }
+    : Object.fromEntries(Object.entries(base).filter(([k]) => k !== 'version'));
+  router.replace({ query: next });
+});
+
+const filteredChangelog = computed(() =>
+  selectedVersion.value
+    ? changelogEntries.filter((e) => e.version === selectedVersion.value)
+    : changelogEntries,
+);
+
+function sectionSlug(title: string): string {
+  return title
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-|-$/g, '');
+}
+
+function formatDate(dateStr: string): string {
+  const d = new Date(dateStr);
+  return d.toLocaleDateString('en-US', {
+    year: 'numeric',
+    month: 'long',
+    day: 'numeric',
+  });
+}
+
+async function copyLink(hash: string) {
+  const url = `${window.location.origin}${window.location.pathname}${hash}`;
+  try {
+    await navigator.clipboard.writeText(url);
+  } catch {
+    // fallback
+  }
+}
+</script>
+
+<style scoped>
+.changelog-page {
+  max-width: 720px;
+  margin: 0 auto;
+  padding: 2rem 2.5rem;
+}
+
+.changelog-hero {
+  margin-bottom: 2.5rem;
+}
+
+.changelog-hero h1 {
+  font-size: 2rem;
+  font-weight: 700;
+  margin-bottom: 0.5rem;
+  letter-spacing: -0.02em;
+}
+
+.lead {
+  font-size: 1rem;
+  color: var(--text-secondary);
+  line-height: 1.6;
+}
+
+.version-filter {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+  margin-top: 1.25rem;
+}
+
+.filter-pill {
+  font-size: 0.85rem;
+  font-weight: 500;
+  padding: 0.4rem 0.85rem;
+  border-radius: 9999px;
+  border: 1px solid var(--border);
+  background: var(--bg-tertiary);
+  color: var(--text-secondary);
+  cursor: pointer;
+  transition:
+    color 0.15s,
+    border-color 0.15s,
+    background 0.15s;
+}
+
+.filter-pill:hover {
+  color: var(--text-primary);
+  border-color: var(--border);
+  background: var(--bg-hover);
+}
+
+.filter-pill.active {
+  border-color: var(--accent);
+  color: var(--accent);
+  background: color-mix(in srgb, var(--accent) 12%, transparent);
+}
+
+.changelog-entries {
+  display: flex;
+  flex-direction: column;
+  gap: 2rem;
+}
+
+.changelog-entry {
+  padding-bottom: 2rem;
+  border-bottom: 1px solid var(--border);
+}
+
+.changelog-entry:last-child {
+  border-bottom: none;
+}
+
+.entry-header {
+  display: flex;
+  align-items: baseline;
+  gap: 1rem;
+  margin-bottom: 1rem;
+}
+
+.entry-version {
+  font-size: 1.25rem;
+  font-weight: 600;
+  font-family: 'JetBrains Mono', ui-monospace, monospace;
+  letter-spacing: -0.02em;
+  margin: 0;
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.entry-date {
+  font-size: 0.9rem;
+  color: var(--text-muted);
+}
+
+.section {
+  margin-bottom: 1.5rem;
+}
+
+.section:last-child {
+  margin-bottom: 0;
+}
+
+.section-title {
+  font-size: 0.95rem;
+  font-weight: 600;
+  color: var(--text-primary);
+  margin: 0 0 0.5rem 0;
+  letter-spacing: 0.01em;
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.entry-version {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.copy-link-btn {
+  background: none;
+  border: none;
+  color: var(--text-muted);
+  font-size: 0.85em;
+  font-family: 'JetBrains Mono', ui-monospace, monospace;
+  cursor: pointer;
+  padding: 0.2em 0.4em;
+  border-radius: var(--radius-sm);
+  opacity: 0.6;
+  transition:
+    opacity 0.15s,
+    color 0.15s;
+}
+
+.copy-link-btn:hover {
+  opacity: 1;
+  color: var(--accent);
+}
+
+.section-items {
+  margin: 0;
+  padding-left: 1.25rem;
+  list-style: disc;
+}
+
+.item {
+  padding: 0.2rem 0;
+  font-size: 0.9rem;
+  line-height: 1.65;
+  color: var(--text-secondary);
+}
+</style>