@geenius/docs 0.1.0

package/.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.1/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

package/.github/CODEOWNERS

@@ -0,0 +1 @@
+* @mxn2020

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,16 @@
+---
+name: Bug Report
+about: Report a bug
+labels: bug
+---
+
+## Describe the bug
+
+## Steps to reproduce
+
+## Expected behavior
+
+## Environment
+- Package version:
+- Node version:
+- OS:

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,11 @@
+---
+name: Feature Request
+about: Suggest a new feature
+labels: enhancement
+---
+
+## Problem
+
+## Proposed solution
+
+## Alternatives considered

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,10 @@
+## What
+
+## Why
+
+## How
+
+## Checklist
+- [ ] Tests added/updated
+- [ ] `pnpm changeset` run (if applicable)
+- [ ] Documentation updated

package/.github/dependabot.yml

@@ -0,0 +1,11 @@
+version: 2
+updates:
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

package/.github/workflows/ci.yml

@@ -0,0 +1,23 @@
+name: CI
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+jobs:
+  check:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: '.nvmrc'
+          cache: 'pnpm'
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm build
+      - run: pnpm lint
+      - run: pnpm test

package/.github/workflows/release.yml

@@ -0,0 +1,29 @@
+name: Release
+on:
+  push:
+    branches: [main]
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: '.nvmrc'
+          cache: 'pnpm'
+          registry-url: 'https://registry.npmjs.org'
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm build
+      - uses: changesets/action@v1
+        with:
+          publish: pnpm changeset publish
+          version: pnpm changeset version
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.nvmrc

@@ -0,0 +1 @@
+22

package/.project/ACCOUNT.yaml

@@ -0,0 +1,4 @@
+owner: Mehdi Nabhani
+email: mehdi@geenius.app
+github: mxn2020
+organization: geenius

package/.project/IDEAS.yaml

@@ -0,0 +1,7 @@
+ideas:
+  - title: "CLI scaffolding"
+    description: "Add a create command to geenius-cli for this package"
+    priority: medium
+  - title: "Vue adapter"
+    description: "Add Vue 3 support alongside React and SolidJS"
+    priority: low

package/.project/PROJECT.yaml

@@ -0,0 +1,11 @@
+name: geenius-docs
+description: "Geenius Docs — Provider-based documentation system (Astro/Fumadocs/Internal) for React + SolidJS"
+category: library
+priority: high
+tags:
+  - geenius
+  - npm-package
+  - react
+  - solidjs
+deploy_url: null
+npm_scope: "@geenius-docs"

package/.project/ROADMAP.yaml

@@ -0,0 +1,15 @@
+version: "0.1"
+milestones:
+  - name: "v0.1.0 — Initial Release"
+    status: in-progress
+    items:
+      - "Core shared types and logic"
+      - "React hooks and components"
+      - "SolidJS primitives"
+      - "npm publishing via Changesets"
+  - name: "v0.2.0 — Stability"
+    status: planned
+    items:
+      - "Test coverage ≥ 50%"
+      - "API documentation"
+      - "Convex adapter"

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-03-20
+
+### Added
+- Initial release

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,16 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+education, socio-economic status, nationality, personal appearance, race,
+religion, or sexual identity and orientation.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the project team at conduct@geenius.app.
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1.

package/CONTRIBUTING.md

@@ -0,0 +1,26 @@
+# Contributing to @geenius-docs
+
+Thank you for your interest in contributing!
+
+## Development Setup
+
+```bash
+git clone https://github.com/mxn2020/geenius-docs.git
+cd geenius-docs
+pnpm install
+pnpm build
+pnpm test
+```
+
+## Pull Request Process
+
+1. Fork the repo and create a feature branch from `main`
+2. Add or update tests as appropriate
+3. Run `pnpm changeset` to describe your changes for the changelog
+4. Open a PR against `main`
+
+## Code Style
+
+- TypeScript strict mode
+- ESLint + Prettier formatting
+- Conventional commits preferred

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Mehdi Nabhani
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1 @@
+# ✦ geenius-docs\n\n> Geenius Docs — Provider-based documentation system (Astro/Fumadocs/Internal) for React + SolidJS\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\n```\n\n## Usage\n\n```typescript\nimport { init } from 'geenius-docs';\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/SECURITY.md

@@ -0,0 +1,15 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported |
+| ------- | --------- |
+| 0.x.x   | ✅        |
+
+## Reporting a Vulnerability
+
+Please report security vulnerabilities by emailing **security@geenius.app**.
+
+Do **not** open a public GitHub issue for security vulnerabilities.
+
+We will acknowledge receipt within 48 hours and provide a detailed response within 5 business days.

package/SUPPORT.md

@@ -0,0 +1,8 @@
+# Support
+
+## Getting Help
+
+- 📖 [Documentation](https://docs.geenius.app)
+- 🐛 [Bug Reports](https://github.com/mxn2020/geenius-docs/issues/new?template=bug_report.md)
+- 💡 [Feature Requests](https://github.com/mxn2020/geenius-docs/issues/new?template=feature_request.md)
+- 📧 Email: support@geenius.app

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@geenius/docs",
+  "type": "module",
+  "version": "0.1.0",
+  "description": "Geenius Docs — Provider-based documentation system (Astro/Fumadocs/Internal) for React + SolidJS",
+  "author": "Antigravity HQ",
+  "license": "MIT",
+  "keywords": [
+    "docs",
+    "documentation",
+    "mdx",
+    "astro",
+    "fumadocs",
+    "react",
+    "solidjs",
+    "geenius"
+  ],
+  "scripts": {
+    "build": "pnpm -r build",
+    "clean": "pnpm -r clean",
+    "type-check": "pnpm -r type-check"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./packages/shared/dist/index.d.ts",
+      "import": "./packages/shared/dist/index.js"
+    },
+    "./shared": {
+      "types": "./packages/shared/dist/index.d.ts",
+      "import": "./packages/shared/dist/index.js"
+    },
+    "./convex": {
+      "types": "./packages/convex/dist/index.d.ts",
+      "import": "./packages/convex/dist/index.js"
+    },
+    "./react": {
+      "types": "./packages/react/dist/index.d.ts",
+      "import": "./packages/react/dist/index.js"
+    },
+    "./react-css": {
+      "types": "./packages/react-css/dist/index.d.ts",
+      "import": "./packages/react-css/dist/index.js"
+    },
+    "./solidjs": {
+      "types": "./packages/solidjs/dist/index.d.ts",
+      "import": "./packages/solidjs/dist/index.js"
+    },
+    "./solidjs-css": {
+      "types": "./packages/solidjs-css/dist/index.d.ts",
+      "import": "./packages/solidjs-css/dist/index.js"
+    }
+  },
+  "main": "./packages/shared/dist/index.js",
+  "types": "./packages/shared/dist/index.d.ts"
+}

package/packages/convex/README.md

@@ -0,0 +1 @@
+# ✦ @geenius-docs/convex\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/convex\n```\n\n## Usage\n\n```typescript\nimport { init } from '@geenius-docs/convex';\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/convex/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@geenius-docs/convex",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "src/index.ts",
+  "author": "Antigravity HQ",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/packages/convex/src/convex.config.ts

@@ -0,0 +1,3 @@
+import { defineComponent } from "convex/server";
+const component = defineComponent("docs");
+export default component;

package/packages/convex/src/index.ts

@@ -0,0 +1,3 @@
+export { default as componentDefinition } from "./convex.config";
+export * from "./mutations";
+export * from "./queries";

package/packages/convex/src/mutations.ts

@@ -0,0 +1,270 @@
+import { v } from "convex/values";
+import { mutation } from "./_generated/server.js";
+
+// ─── Sections ────────────────────────────────────────────────
+
+export const createSection = mutation({
+  args: {
+    title: v.string(),
+    slug: v.string(),
+    parentId: v.optional(v.id("doc_sections")),
+    order: v.number(),
+    icon: v.optional(v.string()),
+    description: v.optional(v.string()),
+    access: v.union(v.literal("public"), v.literal("team"), v.literal("admin")),
+  },
+  returns: v.id("doc_sections"),
+  handler: async (ctx, args) => {
+    return await ctx.db.insert("doc_sections", {
+      ...args,
+      createdAt: Date.now(),
+    });
+  },
+});
+
+export const updateSection = mutation({
+  args: {
+    sectionId: v.id("doc_sections"),
+    title: v.optional(v.string()),
+    slug: v.optional(v.string()),
+    order: v.optional(v.number()),
+    icon: v.optional(v.string()),
+    description: v.optional(v.string()),
+    access: v.optional(
+      v.union(v.literal("public"), v.literal("team"), v.literal("admin"))
+    ),
+  },
+  returns: v.null(),
+  handler: async (ctx, args) => {
+    const { sectionId, ...updates } = args;
+    const clean = Object.fromEntries(
+      Object.entries(updates).filter(([, val]) => val !== undefined)
+    );
+    await ctx.db.patch(sectionId, clean);
+    return null;
+  },
+});
+
+export const deleteSection = mutation({
+  args: { sectionId: v.id("doc_sections") },
+  returns: v.null(),
+  handler: async (ctx, args) => {
+    // Delete all pages in this section
+    const pages = await ctx.db
+      .query("doc_pages")
+      .withIndex("by_sectionId", (q) => q.eq("sectionId", args.sectionId))
+      .collect();
+
+    for (const page of pages) {
+      // Delete search index entries for each page
+      const indexEntries = await ctx.db
+        .query("doc_search_index")
+        .withIndex("by_pageId", (q) => q.eq("pageId", page._id))
+        .collect();
+      for (const entry of indexEntries) {
+        await ctx.db.delete(entry._id);
+      }
+      await ctx.db.delete(page._id);
+    }
+
+    await ctx.db.delete(args.sectionId);
+    return null;
+  },
+});
+
+export const reorderSections = mutation({
+  args: { sectionIds: v.array(v.id("doc_sections")) },
+  returns: v.null(),
+  handler: async (ctx, args) => {
+    for (let i = 0; i < args.sectionIds.length; i++) {
+      await ctx.db.patch(args.sectionIds[i], { order: i });
+    }
+    return null;
+  },
+});
+
+// ─── Pages ───────────────────────────────────────────────────
+
+export const createPage = mutation({
+  args: {
+    title: v.string(),
+    slug: v.string(),
+    content: v.string(),
+    sectionId: v.id("doc_sections"),
+    access: v.union(v.literal("public"), v.literal("team"), v.literal("admin")),
+    tags: v.optional(v.array(v.string())),
+    version: v.optional(v.string()),
+    status: v.optional(
+      v.union(
+        v.literal("draft"),
+        v.literal("published"),
+        v.literal("archived")
+      )
+    ),
+    author: v.optional(
+      v.object({ name: v.string(), avatar: v.optional(v.string()) })
+    ),
+    excerpt: v.optional(v.string()),
+    order: v.optional(v.number()),
+  },
+  returns: v.id("doc_pages"),
+  handler: async (ctx, args) => {
+    const now = Date.now();
+    const stripped = args.content
+      .replace(/```[\s\S]*?```/g, "")
+      .replace(/[#*_~>|-]/g, "")
+      .trim();
+    const words = stripped.split(/\s+/).filter(Boolean);
+    const wordCount = words.length;
+    const readingTime = Math.max(1, Math.ceil(wordCount / 225));
+
+    return await ctx.db.insert("doc_pages", {
+      title: args.title,
+      slug: args.slug,
+      content: args.content,
+      excerpt: args.excerpt,
+      sectionId: args.sectionId,
+      order: args.order ?? 0,
+      author: args.author ?? { name: "Anonymous" },
+      version: args.version,
+      access: args.access,
+      tags: args.tags ?? [],
+      status: args.status ?? "draft",
+      createdAt: now,
+      updatedAt: now,
+      wordCount,
+      readingTime,
+      viewCount: 0,
+    });
+  },
+});
+
+export const updatePage = mutation({
+  args: {
+    pageId: v.id("doc_pages"),
+    title: v.optional(v.string()),
+    slug: v.optional(v.string()),
+    content: v.optional(v.string()),
+    excerpt: v.optional(v.string()),
+    sectionId: v.optional(v.id("doc_sections")),
+    order: v.optional(v.number()),
+    access: v.optional(
+      v.union(v.literal("public"), v.literal("team"), v.literal("admin"))
+    ),
+    tags: v.optional(v.array(v.string())),
+    version: v.optional(v.string()),
+    status: v.optional(
+      v.union(
+        v.literal("draft"),
+        v.literal("published"),
+        v.literal("archived")
+      )
+    ),
+    lastEditedBy: v.optional(
+      v.object({ name: v.string(), editedAt: v.string() })
+    ),
+  },
+  returns: v.null(),
+  handler: async (ctx, args) => {
+    const { pageId, ...updates } = args;
+    const clean: Record<string, unknown> = Object.fromEntries(
+      Object.entries(updates).filter(([, val]) => val !== undefined)
+    );
+
+    // Recalculate word count if content changed
+    if (typeof clean.content === "string") {
+      const stripped = (clean.content as string)
+        .replace(/```[\s\S]*?```/g, "")
+        .replace(/[#*_~>|-]/g, "")
+        .trim();
+      const words = stripped.split(/\s+/).filter(Boolean);
+      clean.wordCount = words.length;
+      clean.readingTime = Math.max(1, Math.ceil(words.length / 225));
+    }
+
+    clean.updatedAt = Date.now();
+    await ctx.db.patch(pageId, clean);
+    return null;
+  },
+});
+
+export const publishPage = mutation({
+  args: { pageId: v.id("doc_pages") },
+  returns: v.null(),
+  handler: async (ctx, args) => {
+    await ctx.db.patch(args.pageId, {
+      status: "published",
+      updatedAt: Date.now(),
+    });
+    return null;
+  },
+});
+
+export const archivePage = mutation({
+  args: { pageId: v.id("doc_pages") },
+  returns: v.null(),
+  handler: async (ctx, args) => {
+    await ctx.db.patch(args.pageId, {
+      status: "archived",
+      updatedAt: Date.now(),
+    });
+    return null;
+  },
+});
+
+export const deletePage = mutation({
+  args: { pageId: v.id("doc_pages") },
+  returns: v.null(),
+  handler: async (ctx, args) => {
+    // Delete search index entries
+    const indexEntries = await ctx.db
+      .query("doc_search_index")
+      .withIndex("by_pageId", (q) => q.eq("pageId", args.pageId))
+      .collect();
+    for (const entry of indexEntries) {
+      await ctx.db.delete(entry._id);
+    }
+    await ctx.db.delete(args.pageId);
+    return null;
+  },
+});
+
+export const reorderPages = mutation({
+  args: { pageIds: v.array(v.id("doc_pages")) },
+  returns: v.null(),
+  handler: async (ctx, args) => {
+    for (let i = 0; i < args.pageIds.length; i++) {
+      await ctx.db.patch(args.pageIds[i], { order: i });
+    }
+    return null;
+  },
+});
+
+export const incrementViewCount = mutation({
+  args: { pageId: v.id("doc_pages") },
+  returns: v.null(),
+  handler: async (ctx, args) => {
+    const page = await ctx.db.get(args.pageId);
+    if (page) {
+      await ctx.db.patch(args.pageId, { viewCount: (page.viewCount ?? 0) + 1 });
+    }
+    return null;
+  },
+});
+
+export const movePage = mutation({
+  args: {
+    pageId: v.id("doc_pages"),
+    newSectionId: v.id("doc_sections"),
+    newOrder: v.number(),
+  },
+  returns: v.null(),
+  handler: async (ctx, args) => {
+    await ctx.db.patch(args.pageId, {
+      sectionId: args.newSectionId,
+      order: args.newOrder,
+      updatedAt: Date.now(),
+    });
+    return null;
+  },
+});