@geenius/docs 0.1.0 → 0.4.0

package/packages/shared/src/types.ts

@@ -1,73 +0,0 @@
-// ─── 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

@@ -1,18 +0,0 @@
-{
-  "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

@@ -1,12 +0,0 @@
-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

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

package/packages/solidjs/README.md

@@ -1 +0,0 @@
-# ✦ @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

@@ -1,33 +0,0 @@
-{
-  "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

@@ -1,87 +0,0 @@
-// @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

@@ -1,95 +0,0 @@
-// @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

@@ -1,147 +0,0 @@
-// 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>
-  )
-}

package/packages/solidjs/src/RouterDocsLayout.tsx

@@ -1,161 +0,0 @@
-// src/components/docs/DocsLayout.tsx
-
-import { createSignal, type JSX } from 'solid-js'
-import { Link, useLocation } from '@tanstack/solid-router'
-import { Book, Menu, X, Search, ChevronRight } from 'lucide-solid'
-
-export interface DocItem {
-  slug: string
-  title: string
-  description: string
-  category: string
-  order: number
-}
-
-interface DocsLayoutProps {
-  children: JSX.Element
-  docs: DocItem[]
-  currentSlug?: string
-}
-
-export const DocsLayout: Component<DocsLayoutProps> = ({
-  children,
-  docs,
-  currentSlug,
-}) => {
-  const [isSidebarOpen, setIsSidebarOpen] = createSignal(false)
-  const location = useLocation()
-
-  // Group docs by category
-  const groupedDocs = docs.reduce(
-    (acc, doc) => {
-      if (!acc[doc.category]) {
-        acc[doc.category] = []
-      }
-      acc[doc.category].push(doc)
-      return acc
-    },
-    {} as Record<string, DocItem[]>,
-  )
-
-  // Sort categories and docs within each category
-  const sortedCategories = Object.entries(groupedDocs).sort(([a], [b]) => {
-    const categoryOrder = [
-      'Introduction',
-      'Getting Started',
-      'Guides',
-      'API',
-      'Advanced',
-    ]
-    return categoryOrder.indexOf(a) - categoryOrder.indexOf(b)
-  })
-
-  return (
-    <div class="min-h-screen bg-bg">
-      {/* Mobile Header */}
-      <div class="lg:hidden sticky top-0 z-40 flex items-center justify-between px-4 py-3 bg-card border-b border-border">
-        <Link to="/" class="flex items-center gap-2 text-primary">
-          <Book class="w-5 h-5" />
-          <span class="font-bold">Documentation</span>
-        </Link>
-        <button
-          onClick={() => setIsSidebarOpen(!isSidebarOpen)}
-          class="p-2 rounded-lg hover:bg-bg-muted transition-colors"
-        >
-          {isSidebarOpen ? (
-            <X class="w-5 h-5" />
-          ) : (
-            <Menu class="w-5 h-5" />
-          )}
-        </button>
-      </div>
-
-      <div class="flex">
-        {/* Sidebar */}
-        <aside
-          class={`
-            fixed lg:sticky top-16 left-0 z-30 w-72 h-[calc(100vh-4rem)] overflow-y-auto
-            bg-card border-r border-border transition-transform duration-300
-            lg:translate-x-0
-            ${isSidebarOpen ? 'translate-x-0' : '-translate-x-full'}
-          `}
-        >
-          <div class="p-6">
-            {/* Logo */}
-            <Link
-              to="/"
-              class="hidden lg:flex items-center gap-2 text-primary mb-8"
-            >
-              <Book class="w-6 h-6" />
-              <span class="font-bold text-lg">Documentation</span>
-            </Link>
-
-            {/* Search */}
-            <div class="relative mb-6">
-              <Search class="absolute left-3 top-1/2 -translate-y-1/2 w-4 h-4 text-text-muted" />
-              <input
-                type="text"
-                placeholder="Search docs..."
-                class="w-full pl-10 pr-4 py-2.5 bg-bg-muted border border-border rounded-lg text-sm focus:outline-none focus:ring-2 focus:ring-primary/20 focus:border-primary transition-all"
-              />
-            </div>
-
-            {/* Navigation */}
-            <nav class="space-y-6">
-              {sortedCategories.map(([category, categoryDocs]) => (
-                <div>
-                  <h3 class="text-xs font-bold text-text-muted uppercase tracking-wider mb-3">
-                    {category}
-                  </h3>
-                  <ul class="space-y-1">
-                    {categoryDocs
-                      .sort((a, b) => a.order - b.order)
-                      .map((doc) => {
-                        const isActive = currentSlug === doc.slug
-                        return (
-                          <li>
-                            <Link
-                              to="/docs/$slug"
-                              params={{ slug: doc.slug }}
-                              activeOptions={{ exact: true }}
-                              onClick={() => setIsSidebarOpen(false)}
-                              class={`
-                                flex items-center gap-2 px-3 py-2 rounded-lg text-sm font-medium transition-all
-                                ${
-                                  isActive
-                                    ? 'bg-primary/10 text-primary'
-                                    : 'text-text-muted hover:bg-bg-muted hover:text-text-main'
-                                }
-                              `}
-                            >
-                              <ChevronRight
-                                class={`w-4 h-4 transition-transform ${isActive ? 'rotate-90' : ''}`}
-                              />
-                              {doc.title}
-                            </Link>
-                          </li>
-                        )
-                      })}
-                  </ul>
-                </div>
-              ))}
-            </nav>
-          </div>
-        </aside>
-
-        {/* Overlay for mobile */}
-        {isSidebarOpen && (
-          <div
-            class="fixed inset-0 bg-black/50 z-20 lg:hidden"
-            onClick={() => setIsSidebarOpen(false)}
-          />
-        )}
-
-        {/* Main Content */}
-        <main class="flex-1 min-w-0">
-          <div class="max-w-4xl mx-auto px-6 py-12">{children}</div>
-        </main>
-      </div>
-    </div>
-  )
-}

package/packages/solidjs/src/components/Breadcrumbs.tsx

@@ -1,27 +0,0 @@
-import { For, Show } from 'solid-js'
-import type { BreadcrumbItem } from '@geenius-docs/shared'
-
-export function Breadcrumbs(props: { items: BreadcrumbItem[] }) {
-  return (
-    <Show when={props.items.length > 0}>
-      <nav class="flex items-center gap-1.5 text-sm" aria-label="Breadcrumb">
-        <For each={props.items}>
-          {(item, idx) => (
-            <>
-              <Show when={idx() > 0}>
-                <svg class="h-3.5 w-3.5 shrink-0 text-white/20" viewBox="0 0 16 16" fill="none">
-                  <path d="M6 4l4 4-4 4" stroke="currentColor" stroke-width="1.5" />
-                </svg>
-              </Show>
-              <Show when={idx() === props.items.length - 1} fallback={
-                <a href={item.href} class="truncate text-white/40 transition-colors hover:text-white/70">{item.title}</a>
-              }>
-                <span class="truncate text-white/60">{item.title}</span>
-              </Show>
-            </>
-          )}
-        </For>
-      </nav>
-    </Show>
-  )
-}