@geenius/docs 0.1.0

package/packages/shared/src/providers/internal.ts

@@ -0,0 +1,80 @@
+import type { DocsProvider, DocsPage, DocsSidebar, DocsSection, DocsSearchResult, TocEntry } from '../types'
+
+/**
+ * Internal docs provider — renders docs from an in-memory page array.
+ * Use when loading docs from CMS, API, or static JSON.
+ */
+export class InternalDocsProvider implements DocsProvider {
+  readonly name = 'internal' as const
+  private pages: DocsPage[] = []
+
+  constructor(pages?: DocsPage[]) { if (pages) this.pages = pages }
+
+  setPages(pages: DocsPage[]): void { this.pages = this.linkPages(pages) }
+
+  private linkPages(pages: DocsPage[]): DocsPage[] {
+    const sorted = [...pages].sort((a, b) => (a.order ?? 0) - (b.order ?? 0))
+    return sorted.map((page, i) => ({
+      ...page,
+      prev: i > 0 ? { slug: sorted[i - 1].slug, title: sorted[i - 1].title } : undefined,
+      next: i < sorted.length - 1 ? { slug: sorted[i + 1].slug, title: sorted[i + 1].title } : undefined,
+      toc: page.toc ?? this.extractToc(page.content),
+    }))
+  }
+
+  private extractToc(content: string): TocEntry[] {
+    const regex = /^(#{2,4})\s+(.+)$/gm
+    const entries: TocEntry[] = []
+    let match
+    while ((match = regex.exec(content)) !== null) {
+      const title = match[2].trim()
+      entries.push({ id: title.toLowerCase().replace(/[^a-z0-9]+/g, '-'), title, depth: match[1].length })
+    }
+    return entries
+  }
+
+  async getSidebar(): Promise<DocsSidebar> {
+    const sectionMap = new Map<string, DocsPage[]>()
+    for (const page of this.pages.filter(p => !p.draft)) {
+      const section = page.section || 'General'
+      if (!sectionMap.has(section)) sectionMap.set(section, [])
+      sectionMap.get(section)!.push(page)
+    }
+    const sections: DocsSection[] = [...sectionMap.entries()].map(([title, pages]) => ({
+      title, slug: title.toLowerCase().replace(/[^a-z0-9]+/g, '-'),
+      pages: pages.sort((a, b) => (a.order ?? 0) - (b.order ?? 0)),
+    }))
+    return { sections }
+  }
+
+  async getPage(slug: string): Promise<DocsPage | null> {
+    return this.pages.find(p => p.slug === slug) ?? null
+  }
+
+  async getAllPages(): Promise<DocsPage[]> {
+    return this.pages.filter(p => !p.draft)
+  }
+
+  async search(query: string): Promise<DocsSearchResult[]> {
+    const q = query.toLowerCase()
+    return this.pages.filter(p => !p.draft).map(page => {
+      const matches: DocsSearchResult['matches'] = []
+      if (page.title.toLowerCase().includes(q)) matches.push({ field: 'title', snippet: page.title })
+      if (page.description?.toLowerCase().includes(q)) matches.push({ field: 'description', snippet: page.description })
+      if (page.content.toLowerCase().includes(q)) {
+        const idx = page.content.toLowerCase().indexOf(q)
+        matches.push({ field: 'content', snippet: page.content.slice(Math.max(0, idx - 40), idx + q.length + 40) })
+      }
+      return matches.length > 0 ? { page, matches, score: matches.length } : null
+    }).filter(Boolean) as DocsSearchResult[]
+  }
+
+  async getNavigation(slug: string): Promise<{ prev: DocsPage | null; next: DocsPage | null }> {
+    const page = this.pages.find(p => p.slug === slug)
+    if (!page) return { prev: null, next: null }
+    return {
+      prev: page.prev ? (this.pages.find(p => p.slug === page.prev!.slug) ?? null) : null,
+      next: page.next ? (this.pages.find(p => p.slug === page.next!.slug) ?? null) : null,
+    }
+  }
+}

package/packages/shared/src/types.ts

@@ -0,0 +1,73 @@
+// ─── Docs Types ──────────────────────────────────────────────
+
+export type DocAccess = 'public' | 'team' | 'admin'
+export type DocStatus = 'draft' | 'published' | 'archived'
+
+export interface DocPage {
+  id: string
+  title: string
+  slug: string
+  content: string                    // MDX
+  excerpt?: string
+  sectionId: string
+  order: number
+  author: { name: string; avatar?: string }
+  lastEditedBy?: { name: string; editedAt: string }
+  version?: string                   // e.g. "2.1.0"
+  access: DocAccess
+  tags: string[]
+  status: DocStatus
+  createdAt: string
+  updatedAt: string
+  wordCount: number
+  readingTime: number
+  viewCount: number
+}
+
+export interface DocSection {
+  id: string
+  title: string
+  slug: string
+  parentId?: string                  // max 3 levels
+  order: number
+  icon?: string
+  description?: string
+  access: DocAccess
+  pageCount?: number
+}
+
+export interface SearchResult {
+  pageId: string
+  pageTitle: string
+  sectionTitle: string
+  sectionSlug: string
+  slug: string
+  highlight: string
+  score: number
+  tags: string[]
+}
+
+export interface TocItem {
+  id: string
+  text: string
+  level: 2 | 3 | 4
+  children: TocItem[]
+}
+
+export interface BreadcrumbItem {
+  title: string
+  href: string
+}
+
+export interface DocsConfig {
+  siteName?: string
+  baseUrl?: string
+  defaultAccess?: DocAccess
+  versionsEnabled?: boolean
+  cmdKEnabled?: boolean
+  editPageUrl?: string              // e.g. 'https://github.com/org/repo/edit/main/docs'
+  showReadingTime?: boolean
+  showLastEdited?: boolean
+  showViewCount?: boolean
+  printModeEnabled?: boolean
+}

package/packages/shared/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler"
+  },
+  "include": [
+    "src"
+  ]
+}

package/packages/shared/tsup.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from 'tsup'
+
+export default defineConfig({
+    entry: { index: 'src/index.ts' },
+    outDir: 'dist',
+    format: ['esm'],
+    dts: true,
+    sourcemap: true,
+    clean: true,
+    treeshake: true,
+    external: [],
+})

package/packages/shared/vitest.config.ts

@@ -0,0 +1,4 @@
+import { defineConfig } from 'vitest/config'
+export default defineConfig({
+  test: { globals: true, environment: 'node' },
+})

package/packages/solidjs/README.md

@@ -0,0 +1 @@
+# ✦ @geenius-docs/solidjs\n\n> A premium module for the Geenius Boilerplate Ecosystem.\n\n---\n\n## Overview\nBuilt with Steve Jobs-level minimalism and Jony Ive-level craftsmanship, this package is designed to deliver unparalleled developer experience (DX) and rock-solid performance.\n\n## Installation\n\n```bash\npnpm add @geenius-docs/solidjs\n```\n\n## Usage\n\n```typescript\nimport { init } from '@geenius-docs/solidjs';\n\n// Initialize the module with absolute precision\ninit({\n  mode: 'premium',\n});\n```\n\n## Architecture\n- **Zero-config**: It just works.\n- **Strictly Typed**: Fully written in TypeScript for flawless IntelliSense.\n- **Framework Agnostic**: seamlessly integrates into the Geenius ecosystem.\n\n---\n\n*Designed by Antigravity HQ*\n

package/packages/solidjs/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@geenius-docs/solidjs",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "peerDependencies": {
+    "solid-js": ">=1.8.0"
+  },
+  "dependencies": {
+    "@geenius-docs/shared": "workspace:*",
+    "lucide-solid": "^0.577.0",
+    "remark-gfm": "^4.0.1",
+    "solid-markdown": "^2.1.1"
+  },
+  "scripts": {
+    "type-check": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@tanstack/solid-router": "^1.168.1"
+  },
+  "author": "Antigravity HQ",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/packages/solidjs/src/DocsLayout.tsx

@@ -0,0 +1,87 @@
+// @geenius-docs/solidjs — src/DocsLayout.tsx
+
+import { For, Show, type ParentComponent } from 'solid-js'
+import { useDocs } from './DocsProvider'
+
+export interface DocsLayoutProps {
+  currentPageId?: string
+  onSelectPage?: (id: string) => void
+  searchQuery?: string
+  onSearch?: (query: string) => void
+  searchResults?: unknown[]
+}
+
+/**
+ * DocsLayout — SolidJS sidebar + content layout for documentation.
+ * Uses data-* attributes and ga-docs-* classes for CSS styling.
+ */
+export const DocsLayout: ParentComponent<DocsLayoutProps> = (props) => {
+  const docs = useDocs()
+
+  const q = () => props.searchQuery ?? docs.searchQuery()
+  const results = () => (props.searchResults ?? docs.searchResults()) as Array<{ id: string; title: string; description?: string }>
+  const onSelect = (id: string) => (props.onSelectPage ?? docs.selectPage)(id)
+  const onSearch = (query: string) => (props.onSearch ?? docs.setSearchQuery)(query)
+
+  return (
+    <div class="ga-docs-layout">
+      {/* Sidebar */}
+      <aside class="ga-docs-sidebar">
+        <div class="ga-docs-search">
+          <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"><circle cx="11" cy="11" r="8" /><path d="m21 21-4.3-4.3" /></svg>
+          <input
+            type="text"
+            value={q()}
+            onInput={(e) => onSearch(e.currentTarget.value)}
+            placeholder="Search docs..."
+          />
+        </div>
+
+        <nav>
+          <Show
+            when={!q() || results().length === 0}
+            fallback={
+              <div data-docs-search-results>
+                <p class="ga-docs-nav-group-title">Search Results ({results().length})</p>
+                <For each={results()}>
+                  {(page) => (
+                    <button
+                      class="ga-docs-nav-item"
+                      onClick={() => { onSelect(page.id); onSearch('') }}
+                    >
+                      {page.title}
+                    </button>
+                  )}
+                </For>
+              </div>
+            }
+          >
+            <For each={docs.tree}>
+              {(group) => (
+                <div class="ga-docs-nav-group">
+                  <p class="ga-docs-nav-group-title">{group.title}</p>
+                  <For each={group.children}>
+                    {(page) => (
+                      <button
+                        class="ga-docs-nav-item"
+                        data-active={page.id === props.currentPageId || undefined}
+                        onClick={() => onSelect(page.id)}
+                      >
+                        {page.title}
+                      </button>
+                    )}
+                  </For>
+                </div>
+              )}
+            </For>
+          </Show>
+        </nav>
+      </aside>
+
+      {/* Content */}
+      <main class="ga-docs-content">
+        {props.children}
+      </main>
+    </div>
+  )
+}

package/packages/solidjs/src/DocsProvider.tsx

@@ -0,0 +1,95 @@
+// @geenius-docs/solidjs — src/DocsProvider.tsx
+
+import { createContext, useContext, type ParentComponent } from 'solid-js'
+import { createSignal, createMemo } from 'solid-js'
+
+export interface DocsPage {
+  id: string
+  title: string
+  description?: string
+  content: unknown
+}
+
+export interface DocsGroup {
+  id: string
+  title: string
+  children: DocsPage[]
+}
+
+export type DocsTree = DocsGroup[]
+
+export interface DocsContextValue {
+  tree: DocsTree
+  currentPage: () => DocsPage | null
+  selectPage: (id: string) => void
+  searchQuery: () => string
+  setSearchQuery: (query: string) => void
+  searchResults: () => DocsPage[]
+}
+
+const DocsContext = createContext<DocsContextValue>()
+
+export interface DocsProviderProps {
+  tree: DocsTree
+}
+
+/**
+ * DocsProvider — SolidJS context managing docs state:
+ * current page, search, and tree navigation.
+ */
+export const DocsProvider: ParentComponent<DocsProviderProps> = (props) => {
+  const firstPageId = () => props.tree[0]?.children[0]?.id || null
+  const [currentPageId, setCurrentPageId] = createSignal<string | null>(firstPageId())
+  const [searchQuery, setSearchQuery] = createSignal('')
+
+  const currentPage = createMemo(() => {
+    const id = currentPageId()
+    if (!id) return null
+    for (const group of props.tree) {
+      const page = group.children.find(p => p.id === id)
+      if (page) return page
+    }
+    return null
+  })
+
+  const selectPage = (id: string) => setCurrentPageId(id)
+
+  const searchResults = createMemo(() => {
+    const q = searchQuery().toLowerCase()
+    if (!q) return []
+    const results: DocsPage[] = []
+    for (const group of props.tree) {
+      for (const page of group.children) {
+        if (
+          page.title.toLowerCase().includes(q) ||
+          page.description?.toLowerCase().includes(q) ||
+          (typeof page.content === 'string' && page.content.toLowerCase().includes(q))
+        ) {
+          results.push(page)
+        }
+      }
+    }
+    return results
+  })
+
+  const value: DocsContextValue = {
+    tree: props.tree,
+    currentPage,
+    selectPage,
+    searchQuery,
+    setSearchQuery,
+    searchResults,
+  }
+
+  return (
+    <DocsContext.Provider value={value}>
+      {props.children}
+    </DocsContext.Provider>
+  )
+}
+
+export function useDocs(): DocsContextValue {
+  const ctx = useContext(DocsContext)
+  if (!ctx) throw new Error('useDocs must be used within a DocsProvider')
+  return ctx
+}

package/packages/solidjs/src/RouterDocsContent.tsx

@@ -0,0 +1,147 @@
+// src/components/docs/DocsContent.tsx
+
+import { SolidMarkdown as ReactMarkdown } from 'solid-markdown'
+import remarkGfm from 'remark-gfm'
+import { Link } from '@tanstack/solid-router'
+
+interface DocsContentProps {
+  content: string
+  title: string
+  description: string
+}
+
+export const DocsContent: Component<DocsContentProps> = ({
+  content,
+  title,
+  description,
+}) => {
+  return (
+    <article class="prose prose-lg dark:prose-invert max-w-none">
+      {/* Header */}
+      <header class="mb-8 pb-8 border-b border-border not-prose">
+        <h1 class="text-4xl font-extrabold text-text-main mb-3">{title}</h1>
+        <p class="text-lg text-text-muted">{description}</p>
+      </header>
+
+      {/* Markdown Content */}
+      <ReactMarkdown
+        remarkPlugins={[remarkGfm]}
+        components={{
+          // Custom heading styles
+          h1: ({ children }) => (
+            <h1 class="text-3xl font-bold text-text-main mt-12 mb-6">
+              {children}
+            </h1>
+          ),
+          h2: ({ children }) => (
+            <h2 class="text-2xl font-bold text-text-main mt-10 mb-4 pb-2 border-b border-border">
+              {children}
+            </h2>
+          ),
+          h3: ({ children }) => (
+            <h3 class="text-xl font-bold text-text-main mt-8 mb-3">
+              {children}
+            </h3>
+          ),
+          h4: ({ children }) => (
+            <h4 class="text-lg font-semibold text-text-main mt-6 mb-2">
+              {children}
+            </h4>
+          ),
+          // Paragraph
+          p: ({ children }) => (
+            <p class="text-text-muted leading-relaxed mb-4">{children}</p>
+          ),
+          // Links
+          a: ({ href, children }) => {
+            const isInternal = href?.startsWith('/')
+            if (isInternal) {
+              return (
+                <Link
+                  to={href!}
+                  class="text-primary hover:underline font-medium"
+                >
+                  {children}
+                </Link>
+              )
+            }
+            return (
+              <a
+                href={href}
+                target="_blank"
+                rel="noopener noreferrer"
+                class="text-primary hover:underline font-medium"
+              >
+                {children}
+              </a>
+            )
+          },
+          // Code blocks
+          code: ({ className, children, ...props }) => {
+            const isInline = !className
+            if (isInline) {
+              return (
+                <code class="bg-bg-muted px-1.5 py-0.5 rounded text-sm font-mono text-primary">
+                  {children}
+                </code>
+              )
+            }
+            return (
+              <code class={`${className} block`} {...props}>
+                {children}
+              </code>
+            )
+          },
+          pre: ({ children }) => (
+            <pre class="bg-[#1e1e2e] text-gray-100 p-4 rounded-xl overflow-x-auto text-sm my-6 border border-border">
+              {children}
+            </pre>
+          ),
+          // Lists
+          ul: ({ children }) => (
+            <ul class="list-disc list-inside space-y-2 text-text-muted mb-4">
+              {children}
+            </ul>
+          ),
+          ol: ({ children }) => (
+            <ol class="list-decimal list-inside space-y-2 text-text-muted mb-4">
+              {children}
+            </ol>
+          ),
+          li: ({ children }) => <li class="text-text-muted">{children}</li>,
+          // Tables
+          table: ({ children }) => (
+            <div class="overflow-x-auto my-6">
+              <table class="min-w-full divide-y divide-border border border-border rounded-lg overflow-hidden">
+                {children}
+              </table>
+            </div>
+          ),
+          thead: ({ children }) => (
+            <thead class="bg-bg-muted">{children}</thead>
+          ),
+          th: ({ children }) => (
+            <th class="px-4 py-3 text-left text-sm font-bold text-text-main">
+              {children}
+            </th>
+          ),
+          td: ({ children }) => (
+            <td class="px-4 py-3 text-sm text-text-muted border-t border-border">
+              {children}
+            </td>
+          ),
+          // Blockquotes
+          blockquote: ({ children }) => (
+            <blockquote class="border-l-4 border-primary pl-4 py-2 my-6 bg-primary/5 rounded-r-lg">
+              {children}
+            </blockquote>
+          ),
+          // Horizontal rules
+          hr: () => <hr class="border-border my-8" />,
+        }}
+      >
+        {content}
+      </ReactMarkdown>
+    </article>
+  )
+}