@erinjs/core 1.0.0

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

@@ -0,0 +1,125 @@
+<template>
+  <div class="home">
+    <div class="hero">
+      <h1>erin.js</h1>
+      <p class="lead">SDK for building bots on Fluxer.</p>
+      <div class="hero-ctas">
+        <router-link to="/v/latest/guides/basic-bot" class="cta-link"
+          >Get started — your first bot</router-link
+        >
+        <CommunityCallout variant="hero" />
+      </div>
+      <nav class="hero-nav">
+        <router-link to="/v/latest/guides" class="nav-link">Guides</router-link>
+        <router-link to="/v/latest/api" class="nav-link">REST API</router-link>
+        <router-link to="/v/latest/docs" class="nav-link">Docs</router-link>
+        <router-link to="/changelog" class="nav-link">Changelog</router-link>
+        <a
+          href="https://github.com/blstmo-abandoned-us-for-the-milk/core"
+          target="_blank"
+          rel="noopener noreferrer"
+          class="nav-link"
+          >GitHub</a
+        >
+        <a
+          href="https://fluxer.gg/fluxer-js"
+          target="_blank"
+          rel="noopener noreferrer"
+          class="nav-link nav-link-external"
+          >Fluxer</a
+        >
+      </nav>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import CommunityCallout from '../components/CommunityCallout.vue';
+</script>
+
+<style scoped>
+.home {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  min-height: 100%;
+}
+
+.hero {
+  text-align: center;
+}
+
+.hero h1 {
+  font-size: 3rem;
+  font-weight: 700;
+  margin-bottom: 0.5rem;
+  letter-spacing: -0.04em;
+}
+
+.lead {
+  font-size: 1.25rem;
+  color: var(--text-secondary);
+  margin-bottom: 1rem;
+}
+
+.cta-link {
+  display: inline-flex;
+  align-items: center;
+  font-size: 1rem;
+  font-weight: 600;
+  line-height: 1;
+  color: var(--accent);
+  padding: 0.5rem 1rem;
+  border: 2px solid var(--accent);
+  border-radius: var(--radius);
+  text-decoration: none;
+  transition:
+    background 0.15s,
+    color 0.15s;
+}
+
+.cta-link:hover {
+  background: var(--accent);
+  color: var(--bg-primary);
+}
+
+.hero-ctas {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  justify-content: center;
+  gap: 0.75rem 1rem;
+  margin-bottom: 2rem;
+}
+
+.hero-nav {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  justify-content: center;
+  gap: 1.5rem 2rem;
+}
+
+.nav-link {
+  font-size: 1rem;
+  font-weight: 600;
+  color: var(--text-primary);
+  text-decoration: none;
+  padding: 0.5rem 0;
+  border-bottom: 2px solid transparent;
+  transition:
+    color 0.15s,
+    border-color 0.15s;
+}
+
+.nav-link:hover {
+  color: var(--accent);
+  border-bottom-color: var(--accent);
+}
+
+.nav-link-external::after {
+  content: ' ↗';
+  font-size: 0.8em;
+  opacity: 0.7;
+}
+</style>

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

@@ -0,0 +1,57 @@
+<template>
+  <div class="not-found-page">
+    <h1>404</h1>
+    <p class="message">Page not found.</p>
+    <p class="hint">The page you're looking for doesn't exist or has been moved.</p>
+    <nav class="not-found-nav">
+      <router-link to="/" class="nav-link">Home</router-link>
+      <router-link to="/v/latest/guides" class="nav-link">Guides</router-link>
+      <router-link to="/v/latest/docs" class="nav-link">Docs</router-link>
+      <router-link to="/changelog" class="nav-link">Changelog</router-link>
+    </nav>
+  </div>
+</template>
+
+<script setup lang="ts"></script>
+
+<style scoped>
+.not-found-page {
+  max-width: 480px;
+  margin: 4rem auto;
+  padding: 2rem;
+  text-align: center;
+}
+
+.not-found-page h1 {
+  font-size: 4rem;
+  font-weight: 700;
+  color: var(--text-muted);
+  margin-bottom: 0.5rem;
+  letter-spacing: -0.04em;
+}
+
+.message {
+  font-size: 1.25rem;
+  font-weight: 600;
+  color: var(--text-primary);
+  margin-bottom: 0.5rem;
+}
+
+.hint {
+  font-size: 0.95rem;
+  color: var(--text-secondary);
+  margin-bottom: 2rem;
+  line-height: 1.5;
+}
+
+.not-found-nav {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: center;
+  gap: 1rem;
+}
+
+.nav-link {
+  font-weight: 500;
+}
+</style>

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

@@ -0,0 +1,230 @@
+<template>
+  <div v-if="typedef" class="typedef-page">
+    <div class="page-header">
+      <span :class="['kind-badge', isInterface ? 'kind-interface' : 'kind-enum']">
+        {{ isInterface ? 'interface' : 'enum' }}
+      </span>
+      <h1>{{ typedef.name }}</h1>
+    </div>
+    <p v-if="typedef.description" class="description">
+      <DocDescription :text="typedef.description" />
+    </p>
+
+    <a
+      v-if="typedef.source?.path"
+      :href="sourceUrl(typedef.source)"
+      target="_blank"
+      rel="noopener noreferrer"
+      class="source-link">
+      View source
+    </a>
+
+    <PropertiesSection
+      v-if="isInterface && properties.length"
+      :properties="properties"
+      :parent-name="typedef?.name"
+      parent-type="typedef" />
+    <section v-else-if="isEnum && members.length" class="section enum-section">
+      <h2>Members</h2>
+      <div class="enum-definition">
+        <pre><code class="language-typescript">{{ enumDefinition }}</code></pre>
+      </div>
+      <table class="enum-table">
+        <thead>
+          <tr>
+            <th>Member</th>
+            <th>Value</th>
+          </tr>
+        </thead>
+        <tbody>
+          <tr v-for="m in members" :key="m.name">
+            <td>
+              <code>{{ m.name }}</code>
+            </td>
+            <td>
+              <code>{{ formatValue(m.value) }}</code>
+            </td>
+          </tr>
+        </tbody>
+      </table>
+    </section>
+  </div>
+  <div v-else-if="store.loading" class="loading">
+    <p>Loading...</p>
+  </div>
+  <div v-else-if="store.error" class="error">
+    <p>Failed to load docs: {{ store.error }}</p>
+  </div>
+  <div v-else class="not-found">
+    <p>Type not found.</p>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { computed } from 'vue';
+import { useRoute } from 'vue-router';
+import { useDocsStore } from '../stores/docs';
+import { DocInterface, DocEnum } from '../types/doc-schema';
+import { onMounted, watch } from 'vue';
+import DocDescription from '../components/DocDescription.vue';
+import PropertiesSection from '../components/PropertiesSection.vue';
+import Prism from 'prismjs';
+
+const route = useRoute();
+const store = useDocsStore();
+
+onMounted(() => Prism.highlightAll());
+watch(
+  () => route.params.typedef,
+  () => {
+    queueMicrotask(() => Prism.highlightAll());
+  },
+);
+
+const typedef = computed(() => {
+  const doc = store.currentDoc;
+  const name = route.params.typedef as string;
+  if (!doc || !name) return null;
+  const iface = doc.interfaces?.find((i) => i.name === name);
+  if (iface) return iface;
+  const enm = doc.enums?.find((e) => e.name === name);
+  return enm ?? null;
+});
+
+const isInterface = computed(() => typedef.value && 'properties' in typedef.value);
+
+const isEnum = computed(() => typedef.value && 'members' in typedef.value);
+
+const properties = computed(() =>
+  isInterface.value && typedef.value ? ((typedef.value as DocInterface).properties ?? []) : [],
+);
+
+const members = computed(() =>
+  isEnum.value && typedef.value ? ((typedef.value as DocEnum).members ?? []) : [],
+);
+
+const enumDefinition = computed(() => {
+  const name = typedef.value?.name ?? '';
+  const mems = members.value;
+  const lines = mems.map((m) => {
+    if (m.value === m.name) return `  ${m.name}`;
+    const val = formatValue(m.value);
+    return `  ${m.name} = ${val}`;
+  });
+  return `enum ${name} {\n${lines.join(',\n')}\n}`;
+});
+
+function formatValue(v: string | number): string {
+  return typeof v === 'string' ? `"${v}"` : String(v);
+}
+
+const GITHUB_BASE = 'https://github.com/blstmo-abandoned-us-for-the-milk/core/blob/main';
+function sourceUrl(source: { file: string; line: number; path?: string }) {
+  return `${GITHUB_BASE}/${source.path}#L${source.line}`;
+}
+</script>
+
+<style scoped>
+.typedef-page {
+  max-width: 720px;
+}
+
+.page-header {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  margin-bottom: 0.5rem;
+}
+
+.kind-badge {
+  font-size: 0.65rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  padding: 0.25em 0.6em;
+  border-radius: var(--radius-sm);
+  font-family: 'JetBrains Mono', ui-monospace, monospace;
+}
+
+.kind-interface {
+  background: var(--badge-interface-bg);
+  color: var(--badge-interface);
+}
+
+.kind-enum {
+  background: var(--badge-enum-bg);
+  color: var(--badge-enum);
+}
+
+h1 {
+  font-size: 1.75rem;
+}
+
+.description {
+  color: var(--text-secondary);
+  font-size: 0.95rem;
+  margin-bottom: 1rem;
+}
+
+.source-link {
+  display: inline-block;
+  font-size: 0.85rem;
+  margin-bottom: 1.5rem;
+}
+
+.section h2 {
+  font-size: 0.85rem;
+  font-weight: 600;
+  color: var(--text-muted);
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  margin-bottom: 1rem;
+}
+
+.enum-section {
+  margin-top: 1.5rem;
+}
+
+.enum-definition {
+  margin-bottom: 1.25rem;
+}
+
+.enum-definition pre {
+  margin: 0;
+  border-radius: var(--radius);
+}
+
+.enum-table {
+  width: 100%;
+  font-size: 0.875rem;
+  border-collapse: collapse;
+}
+
+.enum-table th,
+.enum-table td {
+  padding: 0.5rem 0.75rem;
+  text-align: left;
+  border-bottom: 1px solid var(--border-subtle);
+  vertical-align: middle;
+}
+
+.enum-table th {
+  color: var(--text-muted);
+  font-weight: 600;
+  font-size: 0.75rem;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+}
+
+.enum-table code {
+  font-size: 0.875rem;
+}
+
+.loading,
+.not-found {
+  color: var(--text-muted);
+}
+
+.error {
+  color: var(--text-error, #dc2626);
+}
+</style>

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

@@ -0,0 +1,168 @@
+<template>
+  <div class="typedefs-list">
+    <h1>API Types</h1>
+    <p class="lead">Interfaces and enums used across the erin.js SDK.</p>
+
+    <p v-if="store.loading">Loading...</p>
+    <p v-else-if="store.error" class="error">{{ store.error }}</p>
+
+    <template v-else>
+      <section v-if="interfaces.length" class="type-section">
+        <h2 class="section-head">
+          <span class="section-badge section-badge-interface">interface</span>
+          Interfaces
+        </h2>
+        <div class="type-grid">
+          <router-link
+            v-for="i in interfaces"
+            :key="i.name"
+            :to="{ name: 'typedef', params: { version: routeVersion, typedef: i.name } }"
+            class="type-card type-card-interface">
+            <code class="type-name">{{ i.name }}</code>
+            <p v-if="i.description" class="type-desc">{{ i.description }}</p>
+          </router-link>
+        </div>
+      </section>
+
+      <section v-if="enums.length" class="type-section">
+        <h2 class="section-head">
+          <span class="section-badge section-badge-enum">enum</span>
+          Enums
+        </h2>
+        <div class="type-grid">
+          <router-link
+            v-for="e in enums"
+            :key="e.name"
+            :to="{ name: 'typedef', params: { version: routeVersion, typedef: e.name } }"
+            class="type-card type-card-enum">
+            <code class="type-name">{{ e.name }}</code>
+            <p v-if="e.description" class="type-desc">{{ e.description }}</p>
+          </router-link>
+        </div>
+      </section>
+
+      <p v-if="!interfaces.length && !enums.length" class="muted">No interfaces or enums found.</p>
+    </template>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { computed } from 'vue';
+import { useRoute } from 'vue-router';
+import { useDocsStore } from '../stores/docs';
+
+const route = useRoute();
+const store = useDocsStore();
+const routeVersion = computed(() => (route.params.version as string) ?? 'latest');
+const interfaces = computed(() => store.currentDoc?.interfaces ?? []);
+const enums = computed(() => store.currentDoc?.enums ?? []);
+</script>
+
+<style scoped>
+.typedefs-list {
+  max-width: 800px;
+}
+
+h1 {
+  font-size: 1.75rem;
+  margin-bottom: 0.35rem;
+}
+
+.lead {
+  font-size: 0.95rem;
+  color: var(--text-secondary);
+  margin-bottom: 2rem;
+}
+
+.type-section {
+  margin-bottom: 2.5rem;
+}
+
+.section-head {
+  font-size: 0.85rem;
+  font-weight: 600;
+  color: var(--text-muted);
+  margin-bottom: 1rem;
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+
+.section-badge {
+  font-size: 0.65rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  padding: 0.2em 0.5em;
+  border-radius: 4px;
+  font-family: 'JetBrains Mono', ui-monospace, monospace;
+}
+
+.section-badge-interface {
+  background: var(--badge-interface-bg);
+  color: var(--badge-interface);
+}
+
+.section-badge-enum {
+  background: var(--badge-enum-bg);
+  color: var(--badge-enum);
+}
+
+.type-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
+  gap: 0.75rem;
+}
+
+.type-card {
+  display: flex;
+  flex-direction: column;
+  padding: 1rem 1.1rem;
+  background: var(--bg-secondary);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  text-decoration: none;
+  color: var(--text-primary);
+  transition:
+    border-color 0.15s,
+    box-shadow 0.15s;
+}
+
+.type-card:hover {
+  border-color: var(--accent);
+  box-shadow: 0 0 0 1px var(--accent);
+}
+
+.type-card-interface {
+  border-left: 3px solid var(--badge-interface);
+}
+
+.type-card-enum {
+  border-left: 3px solid var(--badge-enum);
+}
+
+.type-name {
+  font-family: 'JetBrains Mono', ui-monospace, monospace;
+  font-weight: 500;
+  font-size: 0.9rem;
+}
+
+.type-desc {
+  font-size: 0.8rem;
+  color: var(--text-muted);
+  margin-top: 0.35rem;
+  line-height: 1.4;
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+}
+
+.muted,
+.error {
+  margin-top: 1rem;
+}
+
+.error {
+  color: var(--error);
+}
+</style>

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

@@ -0,0 +1,15 @@
+<template>
+  <div class="version-layout">
+    <router-view />
+  </div>
+</template>
+
+<style scoped>
+.version-layout {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  min-height: 0;
+  overflow: auto;
+}
+</style>

package/core/apps/docs/src/router.ts

@@ -0,0 +1,73 @@
+import Home from './pages/Home.vue';
+import Changelog from './pages/Changelog.vue';
+import NotFound from './pages/NotFound.vue';
+import VersionLayout from './pages/VersionLayout.vue';
+import GuidesLayout from './pages/GuidesLayout.vue';
+import GuidesIndex from './pages/GuidesIndex.vue';
+import GuidePage from './pages/GuidePage.vue';
+import DocsLayout from './pages/DocsLayout.vue';
+import ClassPage from './pages/ClassPage.vue';
+import TypedefPage from './pages/TypedefPage.vue';
+import ApiReferenceLayout from './pages/ApiReferenceLayout.vue';
+import ApiReferencePage from './pages/ApiReferencePage.vue';
+import { RouteRecordRedirectOption } from 'vue-router';
+
+export const routes = [
+  { path: '/', name: 'home', component: Home },
+  { path: '/changelog', name: 'changelog', component: Changelog },
+  { path: '/guides', redirect: '/v/latest/guides' },
+  { path: '/docs', redirect: '/v/latest/docs' },
+  { path: '/api', redirect: '/v/latest/api' },
+  { path: '/v/:version/changelog', redirect: '/changelog' },
+  {
+    path: '/v/:version',
+    component: VersionLayout,
+    children: [
+      {
+        path: '',
+        redirect: ((to: { params: { version?: string } }) =>
+          `/v/${to.params.version}/guides`) as RouteRecordRedirectOption,
+      },
+      {
+        path: 'guides',
+        component: GuidesLayout,
+        children: [
+          { path: '', name: 'guides', component: GuidesIndex },
+          { path: ':slug', name: 'guide', component: GuidePage },
+        ],
+      },
+      {
+        path: 'docs',
+        component: DocsLayout,
+        children: [
+          {
+            path: '',
+            name: 'docs',
+            redirect: ((to: { params: Record<string, string | string[] | undefined> }) => ({
+              name: 'classes',
+              params: { ...to.params },
+            })) as RouteRecordRedirectOption,
+          },
+          {
+            path: 'classes',
+            name: 'classes',
+            component: () => import('./pages/ClassesList.vue'),
+          },
+          { path: 'classes/:class', name: 'class', component: ClassPage },
+          {
+            path: 'typedefs',
+            name: 'typedefs',
+            component: () => import('./pages/TypedefsList.vue'),
+          },
+          { path: 'typedefs/:typedef', name: 'typedef', component: TypedefPage },
+        ],
+      },
+      {
+        path: 'api',
+        component: ApiReferenceLayout,
+        children: [{ path: '', name: 'api', component: ApiReferencePage }],
+      },
+    ],
+  },
+  { path: '/:pathMatch(.*)*', name: 'not-found', component: NotFound },
+];