@documental-xyz/core 0.1.0

package/README.md

@@ -0,0 +1,424 @@
+# Documental 2.0
+
+### Plataforma open-source para criação de sites estáticos focados em geo-narrativas e documentação de direitos humanos
+
+[![Use este modelo](https://img.shields.io/badge/Use%20este%20modelo-2ea44f?style=for-the-badge&logo=github)](https://github.com/thiagopaixao/documentalxyz/generate)
+[![Abrir no Gitpod](https://img.shields.io/badge/Abrir%20no-Gitpod-orange?style=for-the-badge&logo=gitpod)](https://gitpod.io/#https://github.com/thiagopaixao/documentalxyz)
+[![Abrir no StackBlitz](https://img.shields.io/badge/Abrir%20no-StackBlitz-1269d3?style=for-the-badge&logo=stackblitz)](https://stackblitz.com/github/thiagopaixao/documentalxyz)
+[![Deploy no Cloudflare](https://img.shields.io/badge/Deploy-Cloudflare%20Pages-f38020?style=for-the-badge&logo=cloudflare)](https://deploy.workers.cloudflare.com/?url=https://github.com/thiagopaixao/documentalxyz)
+
+## 🚀 Tecnologias
+
+![Astro](https://img.shields.io/badge/Astro-BC52EE?style=for-the-badge&logo=astro&logoColor=white)
+![Sveltia CMS](https://img.shields.io/badge/Sveltia%20CMS-FF3E00?style=for-the-badge&logo=svelte&logoColor=white)
+![Svelte](https://img.shields.io/badge/Svelte-FF3E00?style=for-the-badge&logo=svelte&logoColor=white)
+![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=for-the-badge&logo=typescript&logoColor=white)
+![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?style=for-the-badge&logo=javascript&logoColor=black)
+![MapBox](https://img.shields.io/badge/MapBox-000000?style=for-the-badge&logo=mapbox&logoColor=white)
+![Vite](https://img.shields.io/badge/Vite-646CFF?style=for-the-badge&logo=vite&logoColor=white)
+![SCSS](https://img.shields.io/badge/SCSS-CC6699?style=for-the-badge&logo=sass&logoColor=white)
+
+## 📖 Sobre o Projeto
+
+**Documental 2.0** é uma plataforma open-source para criação de sites estáticos com foco em geo-narrativas para denúncias de violações de direitos humanos. Desenvolvida com tecnologias modernas como Astro e Sveltia CMS, oferece uma solução completa para organizações, jornalistas e ativistas criarem narrativas visuais impactantes com mapas interativos, componentes modulares e sistema de gerenciamento de conteúdo intuitivo. É a base tecnológica do portal Documenta.xyz.
+
+### Motivação
+
+O projeto nasceu da necessidade de democratizar a criação de narrativas digitais que combinam dados geográficos com storytelling para documentar violações de direitos humanos. Muitas organizações e jornalistas independentes enfrentam barreiras técnicas para criar sites que apresentem suas investigações de forma visualmente impactante e geograficamente contextualizada.
+
+A plataforma resolve esse problema oferecendo uma solução técnica robusta, mas acessível, que permite a criação de sites estáticos de alta performance sem necessidade de conhecimento técnico avançado. O sistema de componentes modulares facilita a construção de narrativas complexas, enquanto a integração com MapBox possibilita a criação de mapas interativos sofisticados.
+
+O diferencial está na especialização para geo-narrativas de direitos humanos, oferecendo componentes específicos como linhas do tempo, gráficos de dados, galerias de evidências, comparadores de imagens e mapas com layers customizáveis. Tudo isso mantendo os princípios de código aberto, performance otimizada e facilidade de deploy em plataformas gratuitas como GitHub Pages e Cloudflare Pages.
+
+## ✨ Principais Funcionalidades
+
+- 🗺️ **Mapas Interativos Avançados** - Integração completa com MapBox, layers customizáveis e filtros dinâmicos
+- 🎨 **30+ Componentes Modulares** - Timeline, gráficos, galerias, comparadores, cards e muito mais
+- 📝 **CMS Visual Integrado** - Sveltia CMS para edição de conteúdo sem necessidade de código
+- 🎭 **Sistema de Temas Dinâmico** - Customização completa de cores, fontes e espaçamentos
+- 🌐 **Multilíngue Nativo** - Suporte a português, inglês e espanhol
+- ⚡ **Performance Otimizada** - Sites estáticos ultra-rápidos com Astro
+- 📱 **Totalmente Responsivo** - Adaptação perfeita para todos os dispositivos
+- 🎬 **Sistema de Animações** - Animações suaves e interações avançadas
+- 🔧 **Altamente Customizável** - Configuração flexível para diferentes tipos de narrativa
+
+## 🏗️ Arquitetura (JAMStack)
+
+O Documental 2.0 segue a arquitetura **JAMStack** (JavaScript, APIs, Markup) para máxima performance e segurança:
+
+- **JavaScript**: Astro como framework principal com componentes Svelte para interatividade
+- **APIs**: Integração com MapBox API para mapas e Sveltia CMS para gerenciamento de conteúdo
+- **Markup**: Geração de sites estáticos otimizados com carregamento ultra-rápido
+
+### Estrutura do Projeto
+
+```
+src/
+├── components/          # 30+ componentes reutilizáveis
+├── layouts/            # Layouts para páginas e componentes
+├── content/            # Conteúdo gerenciado pelo CMS
+├── assets/             # Estilos SCSS e scripts
+└── pages/              # Páginas dinâmicas
+
+public/
+├── admin/              # Configuração do Sveltia CMS
+└── uploads/            # Arquivos de mídia
+```
+
+## 🎯 Diferenciais e Aplicações
+
+### Diferenciais Únicos
+- **Especialização em Direitos Humanos** - Componentes e workflows otimizados para documentação de violações
+- **Geo-narrativas Avançadas** - Sistema completo para storytelling baseado em localização
+- **Zero Configuração** - Deploy imediato em plataformas gratuitas
+- **CMS Visual Poderoso** - Edição intuitiva sem conhecimento técnico
+- **Performance Excepcional** - Sites que carregam em menos de 2 segundos
+
+### Aplicações Práticas
+- 📰 **Jornalismo Investigativo** - Reportagens com mapas e dados interativos
+- 🏛️ **ONGs e Organizações** - Relatórios de impacto e campanhas de conscientização
+- 🎓 **Pesquisa Acadêmica** - Apresentação de estudos com visualizações geográficas
+- 🌍 **Ativismo Digital** - Campanhas de denúncia e mobilização social
+- 📊 **Transparência Pública** - Dashboards de dados governamentais e sociais
+
+## 🚀 Como Usar e Publicar
+
+### Via GitHub Pages
+1. Use este repositório como template
+2. Configure o GitHub Pages nas configurações do repositório
+3. Seus sites serão publicados automaticamente em `https://seuusuario.github.io/seurepositorio`
+
+### Via Cloudflare Pages
+1. Conecte seu repositório ao Cloudflare Pages
+2. Configure o build command: `npm run build`
+3. Diretório de output: `dist`
+4. Deploy automático a cada commit
+
+### Deploy Manual
+```bash
+npm run build
+# Upload da pasta 'dist' para qualquer servidor web
+```
+
+## 💻 Desenvolvimento
+
+### Via Gitpod (Recomendado)
+[![Abrir no Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/thiagopaixao/documentalxyz)
+
+Ambiente de desenvolvimento completo no navegador, sem necessidade de instalação local.
+
+### Via StackBlitz
+[![Abrir no StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/thiagopaixao/documentalxyz)
+
+Editor online com preview em tempo real.
+
+### Desenvolvimento Local
+
+#### Pré-requisitos
+- Node.js 18+ 
+- npm ou yarn
+
+#### Instalação
+```bash
+# Clone o repositório
+git clone https://github.com/thiagopaixao/documentalxyz.git
+cd documentalxyz
+
+# Instale as dependências
+npm install
+
+# Rode os scripts de geração 
+npm run build
+
+# Inicie o servidor de desenvolvimento
+npm run dev
+```
+
+#### Comandos Disponíveis
+
+| Comando | Ação |
+|---------|------|
+| `npm install` | Instala as dependências |
+| `npm run dev` | Inicia servidor local em `localhost:4321` |
+| `npm run build` | Gera build de produção em `./dist/` |
+| `npm run preview` | Preview local do build de produção |
+| `npm run serve` | Serve o build em `localhost:3000` |
+
+### Configuração do CMS
+1. Acesse `/admin` ou `/admin/install.html` no seu site local
+2. Configure a autenticação GitHub nas configurações do Sveltia
+3. Edite o conteúdo através da interface visual
+
+## 🎨 Componentes Disponíveis
+
+### Componentes de Conteúdo
+- **Text** - Textos formatados com Markdown
+- **ImageBlock** - Imagens com legendas
+- **VideoEmbed** - Vídeos do YouTube/Vimeo
+- **HtmlEmbed** - Código HTML customizado
+- **Pullquote** - Citações destacadas
+
+### Componentes de Layout
+- **Columns** - Layouts em colunas responsivas
+- **Group** - Agrupamento de componentes com temas
+- **ColumnSticky** - Conteúdo fixo durante scroll
+- **Spacer** - Espaçamentos customizáveis
+
+### Componentes de Dados
+- **ChartBar** - Gráficos de barras
+- **ChartPercentage** - Gráficos de pizza
+- **BigNumbers** - Números destacados
+- **Timeline** - Linhas do tempo interativas
+
+### Componentes Interativos
+- **Gallery** - Galerias de imagens
+- **Slider** - Carrosséis de conteúdo
+- **Compare** - Comparador de imagens
+- **Cards** - Cards informativos
+- **CardsCall** - Cards com call-to-action
+
+### Componentes de Mapa
+- **Map** - Container principal de mapas
+- **MapBox** - Configuração do MapBox
+- **MapView** - Views específicas do mapa
+
+## 📋 Changelog
+
+### v0.1.0 - Setup Inicial
+- ✨ Configuração inicial do Astro
+- ✨ Estrutura básica de componentes
+- ✨ Workflow do GitHub Actions
+- 🔧 Configurações de build e desenvolvimento
+
+### v0.1.1 - Ajustes Iniciais
+- 🐛 Correção na importação do App.js
+- 🎨 Ajuste nas fontes padrão do conteúdo
+- 🔧 Melhorias na configuração inicial
+
+### v0.2.0 - Integração Sveltia CMS
+- ✨ Instalação e configuração do Sveltia CMS
+- ✨ Implementação de widgets personalizados
+- ✨ Layouts para componentes
+- ✨ Sistema de gerenciamento de conteúdo
+- 📝 Configuração de collections e campos
+
+### v0.2.1 - Correções Sveltia
+- 🐛 Correção de erro com imagens externas
+- 🔧 Remoção de seções desnecessárias
+- 🔧 Desabilitação do preview no Sveltia
+- 🎨 Ajustes na interface do CMS
+
+### v0.2.2 - Melhorias CMS
+- 🔧 Ajuste nos parâmetros de seleção de imagens
+- 🔧 Implementação de roteamento dinâmico
+- 📝 Criação de conteúdo exemplo para home page
+
+### v0.3.0 - Integração MapBox
+- ✨ Implementação da API MapBox
+- ✨ Componentes Map, MapBox e MapView
+- ✨ Sistema básico de layers e filtros
+- ✨ Configuração do Sveltia para mapas
+- 🗺️ Suporte a geo-narrativas interativas
+
+### v0.3.1 - Correções MapBox
+- 🐛 Correção nos campos latitude e longitude
+- 🐛 Ajuste na verificação de valores de array
+- 🐛 Correção de erro undefined em valores nulos
+- 🔧 Melhor tratamento de dados geográficos
+
+### v0.3.2 - Filtros Avançados
+- ✨ Novos filtros para Map Views
+- ✨ Suporte a números float no MapBox
+- 🔧 Reorganização dos campos do MapBox
+- ⚡ Melhorias de performance nos mapas
+
+### v0.3.3 - Otimizações MapBox
+- 🐛 Correções na performance do MapBox
+- 🔧 Melhor organização dos campos por prioridade
+- 📱 Ajustes para dispositivos móveis
+- 🎨 Melhorias na interface de configuração
+
+### v0.4.0 - Componentes Avançados
+- ✨ Componente Timeline interativo
+- ✨ Gráficos de barras e percentuais
+- ✨ Sistema de galeria de imagens
+- ✨ Componente de comparação de imagens
+- ✨ Cards e elementos informativos
+
+### v0.4.1 - Correções Timeline
+- 🐛 Correção na altura da linha vertical do timeline
+- 🔧 Ajustes responsivos no timeline
+- 🎨 Melhorias visuais nos bullets
+
+### v0.4.2 - Ajustes Gráficos
+- 🐛 Correção no cálculo de percentuais nos gráficos
+- 🔧 Remoção de valores padrão desnecessários
+- 🎨 Melhorias nas cores dos gráficos
+
+### v0.5.0 - Sistema de Animações
+- ✨ Implementação de animações de revelação
+- ✨ ScrollObserver para interações
+- ✨ Animações customizadas por componente
+- ✨ Barra de progresso de scroll
+- 🎬 Sistema completo de animações suaves
+
+### v0.5.1 - Correções Animações
+- 🐛 Correção nas animações de revelação da galeria
+- 🔧 Ajustes no sistema de scroll
+- ⚡ Otimizações de performance nas animações
+
+### v0.5.2 - Melhorias ScrollObserver
+- 🔧 Refatoração do ScrollObserver
+- 🔧 Melhor detecção de elementos móveis
+- 🔧 Padronização de labels e variáveis
+
+### v0.6.0 - Temas e Multilíngue
+- ✨ Sistema de customização de temas
+- ✨ Suporte a múltiplos idiomas (PT, EN, ES)
+- ✨ Customização de cores por página
+- ✨ Fontes personalizáveis via Google Fonts
+- 🎨 Sistema completo de identidade visual
+
+### v0.6.1 - Correções Temas
+- 🐛 Correção na implementação de fontes customizadas
+- 🔧 Ajustes nas cores auxiliares
+- 🎨 Melhorias na aplicação de temas
+
+### v0.6.2 - Ajustes Visuais
+- 🔧 Correção na implementação de cores auxiliares
+- 🔧 Ajustes nos blocos de cards
+- 🎨 Melhorias gerais na interface
+
+### v0.7.0 - Otimizações Mobile
+- ✨ Parâmetros específicos para mobile no MapBox
+- ✨ Melhorias responsivas em todos os componentes
+- 📱 Otimizações para dispositivos móveis
+- ⚡ Melhorias gerais de performance
+
+### v0.7.1 - Correções Mobile
+- 🐛 Correção nos parâmetros mobile do MapBox
+- 📱 Ajustes nas legendas mobile
+- 🔧 Melhor tratamento de floating text
+
+### v0.7.2 - Ajustes Responsivos
+- 🔧 Testes e ajustes em componentes
+- 🔧 Melhorias na estrutura de arquivos
+- 📱 Otimizações responsivas adicionais
+
+### v0.8.0 - MapBox Avançado
+- ✨ Sistema avançado de layers e filtros
+- ✨ Melhor organização dos campos do MapBox
+- ✨ Novos widgets para configuração
+- 🗺️ Recursos avançados de geo-narrativa
+- ⚡ Otimizações significativas de performance
+
+### v0.8.1 - Correções Layers
+- 🐛 Correção nos filtros de layers
+- 🔧 Melhorias na aplicação de filtros
+- 🔧 Ajustes nos campos do MapBox para melhor organização
+
+### v0.8.2 - Otimizações Finais MapBox
+- 🔧 Organização final dos campos do MapBox
+- ⚡ Melhorias de performance significativas
+- 🔧 Ajustes para melhor experiência no Sveltia
+
+### v0.9.0 - Preparação Produção
+- ✨ Sistema de ativação/desativação de animações
+- ✨ Melhorias finais na interface
+- ✨ Implementação de ícones customizáveis
+- 📝 Documentação completa
+- 🔧 Otimizações finais para produção
+
+### v0.9.1 - Ajustes Finais
+- 🔧 Atualização de conteúdo
+- 🐛 Correções em campos mobile e legendas
+- 🔧 Remoção acidental do App.js corrigida
+
+### v0.9.2 - Release Candidate
+- 🔧 Correções finais de configuração
+- 📝 Atualização final de conteúdo
+- ✅ Preparação para release estável
+
+## 🗺️ Roadmap
+
+### 🎯 Próximas Versões
+
+### v1.0.0 - Versão final estável
+- [ ] Limpeza completa do repositório
+- [ ] Remoção de dependências não utilizadas
+- [ ] Correção de vulnerabilidades de segurança de dependências
+- [ ] Instalação do Sveltia como dependência
+- [ ] Customização de ícones do CMS
+- [ ] Sistema de blog integrado
+- [ ] Worker para MapBox (proteção de token)
+- [ ] MapBox opcional por página
+- [ ] Configuração de não versionamento da pasta public/upload no repositório git
+
+
+### Backlog
+- [ ] Documentação completa em inglês, português e espanhol
+- [ ] Melhorias na experiência de edição
+- [ ] Templates pré-configurados
+- [ ] Tutoriais interativos
+- [ ] Migração para Astro 5
+- [ ] Novos componentes de visualização
+- [ ] Sistema de plugins/módulos
+- [ ] API para integrações externas
+- [ ] Implementação de multilingagem em português, inglẽs e espanhol
+- [ ] Solução completa para edição no StackBlitz
+
+### 💡 Ideias Futuras
+- 🤖 Wizard para deploy automático no Cloud Flare ou GitHub Pages
+- 🤖 Integração com IA para geração de conteúdo
+- 📊 Dashboard de analytics integrado
+- 🔐 Sistema de autenticação avançado
+- 🌍 Suporte a mais idiomas
+- 📱 App mobile companion
+
+## 👥 Créditos e Colaboradores
+
+### Desenvolvimento Principal
+- **Agência Autônoma** - Idealização e gerenciamento do projeto
+- **Thiago Paixão** - Desenvolvimento do backe-end e arquitetura do projeto
+- **Bruno Berken (Studio Atonal)** - Desenvolvimento do front-end e sistema de animações
+
+
+### Organizações Parceiras
+- **MediaLab.UFRJ** 
+
+
+### Inspiração e Base
+Baseado no trabalho original do **Documenta.xyz** e nas necessidades reais de organizações de direitos humanos.
+
+## Publishing
+
+To publish a new version of `@documental-xyz/core` to npm:
+
+1. Ensure `NPM_TOKEN` is set in GitHub repository secrets
+2. Update version in `package.json`
+3. Create and push a tag:
+   ```bash
+   git tag v0.1.0
+   git push --tags
+   ```
+3. The `publish.yml` workflow will run tests, build, and publish automatically
+
+## 📄 Licença
+
+Este projeto está licenciado sob a **GPL 2.0 License** - veja o arquivo [LICENSE](LICENSE) para detalhes.
+
+### Uso Comercial
+✅ Permitido uso comercial  
+✅ Modificação e distribuição  
+✅ Uso privado  
+✅ Sem garantias  
+
+---
+
+<div align="center">
+
+**Documental 2.0** - Democratizando a criação de geo-narrativas para direitos humanos
+
+[🌐 Website](https://documental.xyz) • [📧 Contato](mailto:contato@autonoma.xyz)
+
+</div>

package/integration.ts

@@ -0,0 +1,113 @@
+import type { AstroIntegration } from 'astro';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import { createYamlMergePlugin } from './src/vite/yaml-merge-plugin';
+import { overrideAliases } from './src/integration/override-aliases';
+
+/** Directory of this module — used to resolve injectRoute entrypoints
+ *  as absolute paths, which Astro requires. Bare specifiers like
+ *  `@documental-xyz/core/admin.astro` do NOT resolve when the integration
+ *  is consumed from the same repo (test harness / self-referencing package).
+ *  Absolute paths work in both self-referencing and node_modules install. */
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export interface CoreOptions {
+  /** GitHub repo for Sveltia CMS backend, e.g. 'documental-xyz/starter' */
+  repo: string;
+  /** Git branch for CMS backend (default 'main') */
+  branch?: string;
+  /** Sveltia CMS auth worker URL */
+  authBaseUrl?: string;
+  /** Media folder path (default 'public/uploads') */
+  mediaFolder?: string;
+  /** Public folder URL prefix (default 'uploads') */
+  publicFolder?: string;
+  /** Site URL override (fallback: process.env.SITE) */
+  site?: string;
+  /** Base path override (fallback: process.env.BASE_PATH) */
+  basePath?: string;
+}
+
+/**
+ * `@documental-xyz/core` Astro integration factory.
+ *
+ * Public entry point: `astro.config.mjs` → `integrations: [core({ repo: 'org/repo' })]`.
+ *
+ * The `astro:config:setup` hook:
+ *   1. injects the `/admin` and `/[slug]` routes via bare specifiers resolved
+ *      through the package `exports` map (T1 POC, T10 wildcards, T12 admin.astro);
+ *   2. injects the global stylesheet on every page via `page-ssr` (T2 POC, T11);
+ *   3. updates Vite config with:
+ *      - the YAML merge plugin (T8) that regenerates `public/admin/config.yml`
+ *        substituting `${REPO}`, `${BRANCH}`, etc. from integration options;
+ *      - `resolve.alias` entries that let consumers drop a local `.astro` file
+ *        in `src/components/` or `src/layouts/` to shadow the core's version
+ *        (T2 POC finding #3 — exact full subpath with `.astro` extension).
+ *
+ * The static `src/pages/` route directory MUST NOT exist in the consumer —
+ * this integration owns the `/` and `/[slug]` routes via `injectRoute`, and a
+ * physical `src/pages/[slug].astro` would create a route conflict. The core
+ * keeps its route entrypoints in `src/routes/` (not `src/pages/`) for this
+ * reason.
+ */
+export default function core(options: CoreOptions): AstroIntegration {
+  if (!options || !options.repo) {
+    throw new Error('core(): "repo" option is required (e.g. "org/repo")');
+  }
+
+  return {
+    name: '@documental-xyz/core',
+    hooks: {
+      'astro:config:setup': ({ injectRoute, injectScript, updateConfig }) => {
+        // 1. Inject routes. Entrypoints MUST be absolute paths resolved
+        //    relative to this module (`__dirname`). Astro 5's route-manifest
+        //    resolver treats the entrypoint as a file path, and bare specifiers
+        //    like `@documental-xyz/core/admin.astro` fail when the integration
+        //    is consumed from the same repo (self-referencing test harness).
+        //    Absolute paths work for both self-referencing and npm install.
+        injectRoute({
+          pattern: '/admin',
+          entrypoint: path.resolve(__dirname, 'src/admin/admin.astro'),
+        });
+
+        injectRoute({
+          pattern: '/[slug]',
+          entrypoint: path.resolve(__dirname, 'src/routes/[slug].astro'),
+        });
+
+        // Home page. Injected at `/` so no physical src/pages/ needed.
+        injectRoute({
+          pattern: '/',
+          entrypoint: path.resolve(__dirname, 'src/routes/index.astro'),
+        });
+
+        // 2. Global SCSS — compiled by the consumer's `sass` dep at build time.
+        //    Resolves via T11's `./styles/*` wildcard export.
+        injectScript(
+          'page-ssr',
+          'import "@documental-xyz/core/styles/main.scss"'
+        );
+
+        // 3. Update Vite config: YAML merge plugin + override aliases.
+        //    `updateConfig` deep-merges, so this composes with any other
+        //    integrations / user vite config cleanly (T2 POC).
+        updateConfig({
+          vite: {
+            plugins: [
+              createYamlMergePlugin({
+                repo: options.repo,
+                branch: options.branch,
+                authBaseUrl: options.authBaseUrl,
+                mediaFolder: options.mediaFolder,
+                publicFolder: options.publicFolder,
+              }),
+            ],
+            resolve: {
+              alias: overrideAliases(),
+            },
+          },
+        });
+      },
+    },
+  };
+}

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@documental-xyz/core",
+  "type": "module",
+  "version": "0.1.0",
+  "description": "Astro integration for Documental — geo-narrative static sites with Sveltia CMS",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Documental-xyz/Core"
+  },
+  "keywords": [
+    "astro-component",
+    "astro-integration",
+    "withastro",
+    "sveltia-cms",
+    "geo-narratives"
+  ],
+  "main": "./integration.ts",
+  "exports": {
+    ".": "./integration.ts",
+    "./integration": "./integration.ts",
+    "./loader": "./src/content/loader.ts",
+    "./admin.astro": "./src/admin/admin.astro",
+    "./pages/*": "./src/routes/*",
+    "./components/*": "./src/components/*",
+    "./layouts/*": "./src/layouts/*",
+    "./styles/*": "./src/assets/styles/*",
+    "./scripts/*": "./src/assets/scripts/*",
+    "./*": "./*",
+    "./node_modules/*": "./node_modules/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src/",
+    "integration.ts",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "dev": "astro dev",
+    "start": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview",
+    "astro": "astro",
+    "serve": "serve dist -l 3000 --single",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "astro-icon": "^0.8.1",
+    "gray-matter": "^4.0.3",
+    "marked": ">=5.0.2",
+    "marked-gfm-heading-id": ">=3.1.2",
+    "marked-mangle": ">=1.1.6",
+    "sass-embedded": "^1.86.3",
+    "sass": "^1.80.5",
+    "svelte": ">=4.0.0",
+    "swiper": "^11.1.14"
+  },
+  "peerDependencies": {
+    "astro": "^5.0.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.61.1",
+    "@typescript-eslint/eslint-plugin": "^8.16.0",
+    "@typescript-eslint/parser": "^8.16.0",
+    "astro-eslint-parser": "^1.1.0",
+    "eslint": "^9.16.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-prettier": "^5.2.1",
+    "glob": "^10.3.10",
+    "js-yaml": "^4.1.0",
+    "prettier": "^3.4.1",
+    "serve": "^14.2.4",
+    "stylelint": "^16.11.0",
+    "stylelint-config-standard": "^36.0.1",
+    "vite-plugin-yaml": "^1.0.5",
+    "vitest": "^4.1.9",
+    "yaml": "^2.6.1"
+  }
+}

package/src/admin/admin.astro

@@ -0,0 +1,29 @@
+---
+// src/admin/admin.astro — Sveltia CMS admin page
+// Injected as the /admin route by `@documental-xyz/core` (see `integration.ts`).
+// The route is wired via `injectRoute({ pattern: '/admin', entrypoint: '@documental-xyz/core/admin.astro' })`.
+// Sveltia CMS is loaded from CDN at build pin `@0.158.1`; bumping is out of scope for T12.
+// At runtime Sveltia fetches `/admin/config.yml` (generated by the Vite YAML-merge plugin from T8).
+---
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Content Manager</title>
+
+    <!-- Patch: force showDirectoryPicker with mode readwrite (needed for Sveltia's local-fs backend) -->
+    <script is:inline>
+      const _showDirectoryPicker = window.showDirectoryPicker;
+      window.showDirectoryPicker = (options = {}) =>
+        _showDirectoryPicker.call(window, { ...options, mode: 'readwrite' });
+    </script>
+
+    <!-- Sveltia CMS — loaded from CDN; `is:inline` keeps Vite from trying to bundle a remote URL -->
+    <script is:inline src="https://unpkg.com/@sveltia/cms@0.158.1/dist/sveltia-cms.js" defer></script>
+  </head>
+
+  <body>
+    <!-- Sveltia CMS injects its UI here at runtime -->
+  </body>
+</html>