open-index/open-npm huggingface dataset:
npm package: @hub-atlas/core
Description: Hub Atlas core engine
Latest version: 0.3.4

# 🚀 HubAtlas

> Uma engine de documentação moderna, extensível e agnóstica de framework.

O **HubAtlas** é um motor de documentação focado em performance, arquitetura limpa e extensibilidade.
Ele transforma arquivos Markdown em uma estrutura navegável pronta para ser utilizada com qualquer servidor ou framework.

---

## ✨ Objetivo

Criar uma engine de documentação:

* 🔹 Independente de framework (Next, Vite, Fastify, etc.)
* 🔹 Modular e extensível
* 🔹 Focada em arquitetura
* 🔹 Preparada para crescer como ecossistema

---

## 🧠 O que o HubAtlas faz

### 📂 Ler arquivos

* Lê arquivos `.md`
* Aceita arquivo único ou diretório
* Suporte a estrutura aninhada

---

### 🌐 Resolver rotas

* Converte estrutura de pastas em rotas
* `index.md` → `/`
* `guide/setup.md` → `/guide/setup`
* Sistema determinístico e previsível

---

### 🌳 Criar árvore de navegação

* Gera estrutura hierárquica automaticamente
* Ideal para sidebar dinâmica
* Base para sistema de busca futura

Exemplo de estrutura gerada:

```ts
{
  path: "/guide",
  children: [
    { path: "/guide/setup" },
    { path: "/guide/config" }
  ]
}
```

---

### 🧩 Parse Markdown → AST → HTML

Pipeline:

```
Markdown
   ↓
AST (Remark)
   ↓
HTML (Rehype)
```

Suporte a:

* Frontmatter
* Slugs automáticos
* Autolink em headings
* Extensível via plugins

---

### 🔌 Expor hooks

O core expõe hooks para personalização:

* Manipulação de AST
* Transformação de HTML
* Interceptação de rotas
* Extensão de pipeline

Exemplo conceitual:

```ts
hubAtlas({
  hooks: {
    onParse(ast) {},
    onRoute(route) {},
    onBuild(tree) {}
  }
})
```

---

## 🏗 Arquitetura

O projeto é dividido em camadas:

```
core/
  loader
  router
  parser
  tree-builder
cli/
adapters/
```

### Core

Responsável por toda lógica de documentação.

### CLI

Interface para rodar via terminal.

### Adapters (futuro)

Integração com:

* Next
* Fastify
* Vite
* Static build

---

## 🚀 Uso

```bash
npx hub-atlas ./docs
```

---

## 📦 Visão futura

* Sistema de plugins
* Busca integrada
* HMR em modo dev
* Adapters oficiais
* Geração estática
* Tema padrão opcional

---

## 🎯 Filosofia

HubAtlas não é um template.
Não é um framework pesado.

É uma engine.

Você escolhe o servidor.
Você escolhe o frontend.
Você controla a arquitetura.

---

## 📜 Licença

MIT

---



src
 ├── fs/        → leitura de arquivos
 ├── graph/     → árvore de navegação
 ├── router/    → resolve URLs
 ├── parser/    → markdown → AST → HTML
 ├── hooks/     → lifecycle
 └── build/     → orquestra tudo
npm package: @hub-atlas/react-vite
Description: This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.
Latest version: 0.1.0

# React + TypeScript + Vite

This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.

Currently, two official plugins are available:

- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react) uses [Babel](https://babeljs.io/) (or [oxc](https://oxc.rs) when used in [rolldown-vite](https://vite.dev/guide/rolldown)) for Fast Refresh
- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh

## React Compiler

The React Compiler is not enabled on this template because of its impact on dev & build performances. To add it, see [this documentation](https://react.dev/learn/react-compiler/installation).

## Expanding the ESLint configuration

If you are developing a production application, we recommend updating the configuration to enable type-aware lint rules:

```js
export default defineConfig([
  globalIgnores(['dist']),
  {
    files: ['**/*.{ts,tsx}'],
    extends: [
      // Other configs...

      // Remove tseslint.configs.recommended and replace with this
      tseslint.configs.recommendedTypeChecked,
      // Alternatively, use this for stricter rules
      tseslint.configs.strictTypeChecked,
      // Optionally, add this for stylistic rules
      tseslint.configs.stylisticTypeChecked,

      // Other configs...
    ],
    languageOptions: {
      parserOptions: {
        project: ['./tsconfig.node.json', './tsconfig.app.json'],
        tsconfigRootDir: import.meta.dirname,
      },
      // other options...
    },
  },
])
```

You can also install [eslint-plugin-react-x](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-x) and [eslint-plugin-react-dom](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom) for React-specific lint rules:

```js
// eslint.config.js
import reactX from 'eslint-plugin-react-x'
import reactDom from 'eslint-plugin-react-dom'

export default defineConfig([
  globalIgnores(['dist']),
  {
    files: ['**/*.{ts,tsx}'],
    extends: [
      // Other configs...
      // Enable lint rules for React
      reactX.configs['recommended-typescript'],
      // Enable lint rules for React DOM
      reactDom.configs.recommended,
    ],
    languageOptions: {
      parserOptions: {
        project: ['./tsconfig.node.json', './tsconfig.app.json'],
        tsconfigRootDir: import.meta.dirname,
      },
      // other options...
    },
  },
])
```
npm package: @hub-ws/core
Description: This library was generated with [Angular CLI](https://github.com/angular/angular-cli) version 14.2.0.
Latest version: 14.0.7

# Core

This library was generated with [Angular CLI](https://github.com/angular/angular-cli) version 14.2.0.

## Code scaffolding

Run `ng generate component component-name --project core` to generate a new component. You can also use `ng generate directive|pipe|service|class|guard|interface|enum|module --project core`.
> Note: Don't forget to add `--project core` or else it will be added to the default project in your `angular.json` file. 

## Build

Run `ng build core` to build the project. The build artifacts will be stored in the `dist/` directory.

## Publishing

After building your library with `ng build core`, go to the dist folder `cd dist/core` and run `npm publish`.

## Running unit tests

Run `ng test core` to execute the unit tests via [Karma](https://karma-runner.github.io).

## Further help

To get more help on the Angular CLI use `ng help` or go check out the [Angular CLI Overview and Command Reference](https://angular.io/cli) page.