@sibyllinesoft/arbiter 0.1.0

package/dist/templates/plopfiles/_modules/docs/mkdocs/templates/docs/architecture/components.md.hbs

@@ -0,0 +1,37 @@
+# Components
+
+## Overview
+
+This document describes the key components of {{titleCase name}}.
+
+{{#if modules}}
+{{#each modules}}
+## {{titleCase this}}
+
+The {{this}} component provides core functionality.
+
+### Responsibilities
+
+- Primary feature implementation
+- Integration with other components
+
+### Usage
+
+```typescript
+import { {{camelCase this}} } from '{{../name}}/{{this}}';
+```
+
+{{/each}}
+{{else}}
+## Core
+
+The main application component.
+
+## API
+
+REST API endpoints and handlers.
+
+## Data
+
+Database models and repositories.
+{{/if}}

package/dist/templates/plopfiles/_modules/docs/mkdocs/templates/docs/architecture/overview.md.hbs

@@ -0,0 +1,43 @@
+# Architecture Overview
+
+## System Design
+
+{{titleCase name}} follows a modular architecture designed for scalability and maintainability.
+
+```mermaid
+graph TB
+    A[Client] --> B[API Gateway]
+    B --> C[Services]
+    C --> D[Database]
+    C --> E[Cache]
+```
+
+## Components
+
+{{#if modules}}
+{{#each modules}}
+### {{titleCase this}}
+
+Module responsible for {{this}} functionality.
+
+{{/each}}
+{{else}}
+### Core Module
+
+The main application logic.
+
+### API Layer
+
+RESTful API endpoints.
+
+### Data Layer
+
+Database and caching.
+{{/if}}
+
+## Design Principles
+
+1. **Modularity** - Each component is self-contained
+2. **Testability** - All components are unit testable
+3. **Scalability** - Horizontal scaling support
+4. **Observability** - Built-in metrics and logging

package/dist/templates/plopfiles/_modules/docs/mkdocs/templates/docs/contributing/development.md.hbs

@@ -0,0 +1,164 @@
+# Development Setup
+
+## Prerequisites
+
+- Node.js 18+ or Bun 1.0+
+- Git
+- Python 3.10+ (for docs)
+{{#if useDocker}}
+- Docker & Docker Compose
+{{/if}}
+
+## Getting Started
+
+### 1. Clone the Repository
+
+```bash
+git clone https://github.com/{{author}}/{{name}}.git
+cd {{name}}
+```
+
+### 2. Install Dependencies
+
+```bash
+{{#if useBun}}
+bun install
+{{else}}
+npm install
+{{/if}}
+```
+
+### 3. Set Up Environment
+
+```bash
+cp .env.example .env
+# Edit .env with your values
+```
+
+### 4. Start Development Server
+
+```bash
+{{#if useBun}}
+bun run dev
+{{else}}
+npm run dev
+{{/if}}
+```
+
+## Code Quality
+
+### Linting
+
+```bash
+# Check for issues
+{{#if useBun}}
+bun run lint
+{{else}}
+npm run lint
+{{/if}}
+
+# Auto-fix issues
+{{#if useBun}}
+bun run lint:fix
+{{else}}
+npm run lint:fix
+{{/if}}
+```
+
+### Formatting
+
+```bash
+{{#if useBun}}
+bun run format
+{{else}}
+npm run format
+{{/if}}
+```
+
+### Type Checking
+
+```bash
+{{#if useBun}}
+bun run typecheck
+{{else}}
+npm run typecheck
+{{/if}}
+```
+
+## Testing
+
+```bash
+# Run all tests
+{{#if useBun}}
+bun test
+{{else}}
+npm test
+{{/if}}
+
+# Run with coverage
+{{#if useBun}}
+bun test --coverage
+{{else}}
+npm run test:coverage
+{{/if}}
+```
+
+## Documentation
+
+### Build Docs
+
+```bash
+# Install Python dependencies
+pip install -r requirements-docs.txt
+
+# Serve locally
+mkdocs serve
+
+# Build for production
+mkdocs build
+```
+
+### API Documentation
+
+API documentation is auto-generated from source code comments.
+
+```bash
+{{#if useBun}}
+bun run docs:backend
+{{else}}
+npm run docs:backend
+{{/if}}
+```
+
+## Project Structure
+
+```
+{{name}}/
+├── .arbiter/          # Arbiter spec files
+├── backend/           # Backend service
+├── frontend/          # Frontend app
+├── docs/              # Documentation
+├── scripts/           # Build scripts
+└── tests/             # Integration tests
+```
+
+## IDE Setup
+
+### VS Code
+
+Recommended extensions:
+
+- Biome (for JS/TS)
+- Tailwind CSS IntelliSense
+- TypeScript Vue Plugin (if using Vue)
+
+### Settings
+
+Add to `.vscode/settings.json`:
+
+```json
+{
+  "editor.defaultFormatter": "biomejs.biome",
+  "editor.formatOnSave": true
+}
+```

package/dist/templates/plopfiles/_modules/docs/mkdocs/templates/docs/contributing/guidelines.md.hbs

@@ -0,0 +1,50 @@
+# Contributing Guidelines
+
+Thank you for your interest in contributing to {{titleCase name}}!
+
+## Code of Conduct
+
+Please read and follow our [Code of Conduct](https://github.com/{{author}}/{{name}}/blob/main/CODE_OF_CONDUCT.md).
+
+## How to Contribute
+
+### Reporting Bugs
+
+1. Check existing issues first
+2. Use the bug report template
+3. Provide reproduction steps
+
+### Suggesting Features
+
+1. Open a discussion first
+2. Describe the use case
+3. Consider implementation impact
+
+### Pull Requests
+
+1. Fork the repository
+2. Create a feature branch
+3. Follow coding standards
+4. Write tests
+5. Update documentation
+6. Submit PR
+
+## Coding Standards
+
+- Use TypeScript strict mode
+- Follow ESLint/Biome rules
+- Write JSDoc comments
+- Keep functions small
+- Write meaningful commit messages
+
+## Commit Messages
+
+Follow [Conventional Commits](https://www.conventionalcommits.org/):
+
+```
+feat: add new feature
+fix: resolve bug
+docs: update documentation
+test: add tests
+refactor: restructure code
+```

package/dist/templates/plopfiles/_modules/docs/mkdocs/templates/docs/getting-started/configuration.md.hbs

@@ -0,0 +1,37 @@
+# Configuration
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+{{#each envVars}}
+| `{{@key}}` | Configuration value | `{{this}}` |
+{{/each}}
+{{#unless envVars}}
+| `NODE_ENV` | Environment mode | `development` |
+| `PORT` | Server port | `3000` |
+{{/unless}}
+
+## Configuration File
+
+Create a `{{name}}.config.js` file in your project root:
+
+```javascript
+export default {
+  // Your configuration here
+};
+```
+
+## TypeScript Support
+
+For TypeScript projects, use `{{name}}.config.ts`:
+
+```typescript
+import type { Config } from '{{name}}';
+
+const config: Config = {
+  // Type-safe configuration
+};
+
+export default config;
+```

package/dist/templates/plopfiles/_modules/docs/mkdocs/templates/docs/getting-started/installation.md.hbs

@@ -0,0 +1,53 @@
+# Installation
+
+## Prerequisites
+
+- Node.js 18+ (or Bun 1.0+)
+- Git
+
+## Quick Install
+
+=== "npm"
+
+    ```bash
+    npm install {{name}}
+    ```
+
+=== "pnpm"
+
+    ```bash
+    pnpm add {{name}}
+    ```
+
+=== "bun"
+
+    ```bash
+    bun add {{name}}
+    ```
+
+## From Source
+
+```bash
+git clone https://github.com/{{author}}/{{name}}.git
+cd {{name}}
+{{#if useBun}}
+bun install
+{{else}}
+npm install
+{{/if}}
+```
+
+## Verify Installation
+
+```bash
+{{#if useBun}}
+bun run --version
+{{else}}
+npm run --version
+{{/if}}
+```
+
+## Next Steps
+
+- [Quick Start Guide](quickstart.md)
+- [Configuration](configuration.md)

package/dist/templates/plopfiles/_modules/docs/mkdocs/templates/docs/getting-started/quickstart.md.hbs

@@ -0,0 +1,39 @@
+# Quick Start
+
+Get up and running with {{titleCase name}} in minutes.
+
+## Basic Usage
+
+```bash
+# Start development server
+{{#if useBun}}
+bun run dev
+{{else}}
+npm run dev
+{{/if}}
+```
+
+## Example
+
+```typescript
+// Example usage
+import { {{camelCase name}} } from '{{name}}';
+
+const app = {{camelCase name}}();
+app.start();
+```
+
+## Configuration
+
+Create a configuration file:
+
+```yaml
+# config.yaml
+name: {{name}}
+environment: development
+```
+
+## What's Next?
+
+- [Configuration Guide](configuration.md) - Customize your setup
+- [Architecture Overview](../architecture/overview.md) - Understand how it works

package/dist/templates/plopfiles/_modules/docs/mkdocs/templates/docs/index.md.hbs

@@ -0,0 +1,44 @@
+# {{titleCase name}}
+
+Welcome to the {{titleCase name}} documentation.
+
+## Overview
+
+{{description}}
+
+## Quick Links
+
+- [Getting Started](getting-started/installation.md) - Install and configure {{titleCase name}}
+- [Architecture](architecture/overview.md) - Understand the system design
+- [API Reference](reference/) - Detailed API documentation
+- [Contributing](contributing/guidelines.md) - Help improve {{titleCase name}}
+
+## Features
+
+{{#if capabilities}}
+{{#each capabilities}}
+- **{{titleCase this}}** - Core capability
+{{/each}}
+{{else}}
+- Feature-rich and extensible
+- Well-documented API
+- Easy to configure
+{{/if}}
+
+## Project Structure
+
+```
+{{name}}/
+{{#if modules}}
+{{#each modules}}
+├── {{this}}/          # {{titleCase this}} module
+{{/each}}
+{{/if}}
+├── docs/              # Documentation
+└── README.md
+```
+
+## Getting Help
+
+- [GitHub Issues](https://github.com/{{author}}/{{name}}/issues) - Report bugs or request features
+- [Discussions](https://github.com/{{author}}/{{name}}/discussions) - Ask questions and share ideas

package/dist/templates/plopfiles/_modules/docs/mkdocs/templates/docs/javascripts/extra.js.hbs

@@ -0,0 +1,23 @@
+// Custom JavaScript for {{name}} documentation
+
+// Add copy button feedback
+document.addEventListener("DOMContentLoaded", () => {
+  // Enhanced code copy functionality
+  document.querySelectorAll(".highlight button.md-clipboard").forEach((button) => {
+    button.addEventListener("click", () => {
+      const tooltip = button.querySelector(".md-clipboard__message");
+      if (tooltip) {
+        tooltip.textContent = "Copied!";
+        setTimeout(() => {
+          tooltip.textContent = "";
+        }, 2000);
+      }
+    });
+  });
+
+  // Add external link icons
+  document.querySelectorAll('a[href^="http"]:not([href*="{{name}}"])').forEach((link) => {
+    link.setAttribute("target", "_blank");
+    link.setAttribute("rel", "noopener noreferrer");
+  });
+});

package/dist/templates/plopfiles/_modules/docs/mkdocs/templates/docs/stylesheets/extra.css.hbs

@@ -0,0 +1,51 @@
+/* Custom styles for {{name}} documentation */
+
+:root {
+  --md-primary-fg-color: #5c6bc0;
+  --md-primary-fg-color--light: #8e99a4;
+  --md-primary-fg-color--dark: #3949ab;
+  --md-accent-fg-color: #7c4dff;
+}
+
+/* Code block improvements */
+.highlight code {
+  font-family: "JetBrains Mono", "Fira Code", monospace;
+}
+
+/* Better inline code */
+code {
+  padding: 0.2em 0.4em;
+  border-radius: 3px;
+}
+
+/* Table improvements */
+.md-typeset table:not([class]) {
+  display: table;
+  width: 100%;
+}
+
+/* Admonition icons */
+.md-typeset .admonition.tip,
+.md-typeset details.tip {
+  border-color: #00bfa5;
+}
+
+/* Better heading spacing */
+.md-typeset h2 {
+  margin-top: 1.5em;
+}
+
+.md-typeset h3 {
+  margin-top: 1.25em;
+}
+
+/* API reference styling */
+.doc-heading {
+  font-family: "JetBrains Mono", monospace;
+}
+
+/* Mermaid diagram styling */
+.mermaid {
+  text-align: center;
+  margin: 2em 0;
+}

package/dist/templates/plopfiles/_modules/docs/mkdocs/templates/mkdocs.yml.hbs

@@ -0,0 +1,141 @@
+site_name: {{titleCase name}} Documentation
+site_description: Documentation for {{name}}
+site_author: {{author}}
+site_url: https://{{name}}.github.io/docs
+
+repo_name: {{name}}
+repo_url: https://github.com/{{author}}/{{name}}
+edit_uri: edit/main/docs/
+
+theme:
+  name: material
+  palette:
+    # Light mode
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      primary: indigo
+      accent: indigo
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    # Dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      primary: indigo
+      accent: indigo
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+  features:
+    - navigation.instant
+    - navigation.tracking
+    - navigation.tabs
+    - navigation.tabs.sticky
+    - navigation.sections
+    - navigation.expand
+    - navigation.path
+    - navigation.indexes
+    - navigation.top
+    - search.suggest
+    - search.highlight
+    - content.tabs.link
+    - content.code.copy
+    - content.code.annotate
+  icon:
+    repo: fontawesome/brands/github
+
+plugins:
+  - search
+  - monorepo
+  - awesome-pages
+  - git-revision-date-localized:
+      enable_creation_date: true
+      type: timeago
+  - minify:
+      minify_html: true
+  - mkdocstrings:
+      handlers:
+        python:
+          options:
+            show_source: true
+            show_root_heading: true
+  - gen-files:
+      scripts:
+        - scripts/gen_ref_pages.py
+  - literate-nav:
+      nav_file: SUMMARY.md
+  - section-index
+
+markdown_extensions:
+  - abbr
+  - admonition
+  - attr_list
+  - def_list
+  - footnotes
+  - md_in_html
+  - tables
+  - toc:
+      permalink: true
+  - pymdownx.arithmatex:
+      generic: true
+  - pymdownx.betterem:
+      smart_enable: all
+  - pymdownx.caret
+  - pymdownx.details
+  - pymdownx.emoji:
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
+  - pymdownx.highlight:
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
+  - pymdownx.inlinehilite
+  - pymdownx.keys
+  - pymdownx.magiclink:
+      repo_url_shorthand: true
+      user: {{author}}
+      repo: {{name}}
+  - pymdownx.mark
+  - pymdownx.smartsymbols
+  - pymdownx.superfences:
+      custom_fences:
+        - name: mermaid
+          class: mermaid
+          format: !!python/name:pymdownx.superfences.fence_code_format
+  - pymdownx.tabbed:
+      alternate_style: true
+  - pymdownx.tasklist:
+      custom_checkbox: true
+  - pymdownx.tilde
+
+nav:
+  - Home: index.md
+  - Getting Started:
+      - Installation: getting-started/installation.md
+      - Quick Start: getting-started/quickstart.md
+      - Configuration: getting-started/configuration.md
+  - Architecture:
+      - Overview: architecture/overview.md
+      - Components: architecture/components.md
+  - API Reference: reference/
+  - Contributing:
+      - Guidelines: contributing/guidelines.md
+      - Development: contributing/development.md
+{{#each subprojects}}
+  - "!include ./{{this}}/mkdocs.yml"
+{{/each}}
+
+extra:
+  social:
+    - icon: fontawesome/brands/github
+      link: https://github.com/{{author}}/{{name}}
+  generator: false
+  analytics:
+    provider: google
+    property: G-XXXXXXXXXX
+
+extra_css:
+  - stylesheets/extra.css
+
+extra_javascript:
+  - javascripts/extra.js

package/dist/templates/plopfiles/_modules/docs/mkdocs/templates/requirements-docs.txt.hbs

@@ -0,0 +1,15 @@
+# MkDocs and plugins
+mkdocs>=1.5.0
+mkdocs-material>=9.5.0
+mkdocs-monorepo-plugin>=1.0.0
+mkdocs-awesome-pages-plugin>=2.9.0
+mkdocs-git-revision-date-localized-plugin>=1.2.0
+mkdocs-minify-plugin>=0.7.0
+mkdocstrings[python]>=0.24.0
+mkdocs-gen-files>=0.5.0
+mkdocs-literate-nav>=0.6.0
+mkdocs-section-index>=0.3.0
+
+# Additional utilities
+pymdown-extensions>=10.0
+pygments>=2.17.0