Ve literal converter

.github/workflows/ci.yml

@@ -0,0 +1,79 @@
+# CI do pacote @arijs/bootswatch-ve — gates DETERMINÍSTICOS (independentes de
+# ambiente). NÃO roda a verificação por screenshots: o pixel-diff absoluto
+# depende das fontes do ambiente (font-AA), então a verificação de fidelidade
+# roda na máquina do mantenedor / num runner com as fontes dos baselines.
+# Ver docs/packaging-plan.md (nota metodológica do fix split-caret).
+
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  package:
+    name: Build & gates do pacote
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      # Gate 1: compila os 27 temas só com o plugin VE; FALHA se sobrar qualquer
+      # literal --bs-* (build-package.mjs sai com código 1).
+      - name: Build do pacote (0 literal em 27 temas)
+        run: npm run pkg:build
+      # Gate 2: monta a raiz publicável (contract + themes + preset + solid).
+      - name: Assembla o pacote publicável
+        run: npm run pkg:pack
+      # Gate 3: fidelidade do preset UnoCSS vs bootstrap.css (46/46, determinístico).
+      - name: Probe do preset
+        run: npm run pkg:probe
+      - name: npm pack --dry-run (dimensiona o tarball)
+        run: cd package && npm pack --dry-run
+
+  generated-up-to-date:
+    name: Fontes geradas estão atualizadas
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      # Regenera as famílias dos 27 temas e falha se o resultado divergir do que
+      # está commitado (pega edição de fonte sem regenerar).
+      - name: Regenera famílias (todos os temas)
+        run: npm run pkg:generate
+      - name: Confirma que nada mudou
+        run: |
+          if ! git diff --quiet -- ve-project2/src/themes; then
+            echo "::error::Fontes geradas desatualizadas. Rode 'npm run pkg:generate' e commite."
+            git diff --stat -- ve-project2/src/themes
+            exit 1
+          fi
+          echo "OK — famílias geradas conferem com o commit."
+
+  lint:
+    name: Lint (informativo)
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      - name: Biome check
+        run: npx biome ci .

.github/workflows/publish.yml

@@ -0,0 +1,94 @@
+# Publish do @arijs/bootswatch-ve no npm — via TRUSTED PUBLISHING (OIDC).
+#
+# Não usa token de longa duração (NPM_TOKEN). O GitHub Actions se autentica no
+# npm por OpenID Connect: o npm aceita o publish deste workflow com um token
+# efêmero assinado, e gera provenance automaticamente. Funciona mesmo com 2FA
+# ligado na conta. (Os tokens "bypass 2FA" estão sendo depreciados — ago/2026
+# param de pular 2FA em ops sensíveis; ~jan/2027 perdem o publish direto.)
+#
+# PRÉ-REQUISITOS (uma vez, no npmjs.com):
+#   Settings do pacote → Trusted Publishers → Add → GitHub Actions:
+#     - Organization/user: arijs
+#     - Repository:        bootswatch-solid
+#     - Workflow filename: publish.yml
+#   Obs.: o pacote precisa existir p/ configurar o trusted publisher. Na 1ª vez,
+#   faça UM publish manual (`npm publish` local, com OTP) p/ criar
+#   @arijs/bootswatch-ve; depois configure o trusted publisher e os próximos
+#   releases publicam sozinhos por aqui.
+#
+# Dispara ao publicar um Release (tag vX.Y.Z) ou manualmente.
+
+name: Publish
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Versão a publicar (sem o "v", ex.: 0.1.0)'
+        required: true
+        type: string
+      dry_run:
+        description: 'npm publish --dry-run (não publica de verdade)'
+        required: false
+        default: false
+        type: boolean
+
+jobs:
+  publish:
+    name: Build + npm publish (OIDC)
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write # necessário p/ o OIDC do trusted publishing
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          registry-url: 'https://registry.npmjs.org'
+
+      # Trusted publishing exige npm >= 11.5.1 (o npm que vem com o Node 22 é
+      # mais antigo). Atualiza o CLI.
+      - name: Atualiza o npm (>= 11.5.1 p/ OIDC)
+        run: npm install -g npm@latest
+
+      - run: npm ci
+
+      # Deriva a versão: da tag do release (tira o "v") ou da entrada manual.
+      - name: Resolve a versão
+        id: ver
+        run: |
+          if [ "${{ github.event_name }}" = "release" ]; then
+            V="${{ github.event.release.tag_name }}"
+            V="${V#v}"
+          else
+            V="${{ github.event.inputs.version }}"
+          fi
+          echo "version=$V" >> "$GITHUB_OUTPUT"
+          echo "Versão resolvida: $V"
+
+      # Gate antes de publicar: 0 literal em todos os temas.
+      - name: Build do pacote (0 literal)
+        run: npm run pkg:build
+
+      - name: Assembla a raiz publicável
+        env:
+          BSVE_VERSION: ${{ steps.ver.outputs.version }}
+        run: npm run pkg:pack
+
+      - name: Confere a versão montada
+        run: node -e "const v=require('./package/package.json').version; if(v!=='${{ steps.ver.outputs.version }}'){console.error('versão divergente:',v);process.exit(1)} console.log('package/package.json →',v)"
+
+      # Sem NODE_AUTH_TOKEN: o OIDC (id-token: write) + trusted publisher
+      # configurado no npmjs.com autenticam o publish. Provenance é automática.
+      - name: npm publish (trusted publishing)
+        working-directory: package
+        run: |
+          if [ "${{ github.event.inputs.dry_run }}" = "true" ]; then
+            npm publish --dry-run
+          else
+            npm publish
+          fi

.gitignore

@@ -1,5 +1,8 @@
 node_modules
 dist
+/_ignore/
+/debug*.log
+/docs/ve-theme-generator-validation
 /public/theme
 /screenshots/**/*.verify.png
 /screenshots/**/*.verify.diff.png
@@ -9,6 +12,7 @@ dist
 /screenshots/**/markup.diff.json
 /screenshots/**/markup.diff.md
 /verify-*.txt
+/verify-run/
 /tmp-*.*
 /ve-project/verify-*.txt
 /debug-*.txt
@@ -17,3 +21,14 @@ dist
 /scripts/debug-*.mjs
 /scripts/tmp-*.mjs
 *.elements.xml
+/debug*.*
+
+# pacote @arijs/bootswatch-ve (Fase 1)
+dist-pkg/
+package/
+ve-project2/src/__pkg/
+
+# demo (F4) — artefatos de build
+examples/demo/dist/
+examples/demo/demo.png
+examples/**/node_modules/

biome.json

@@ -1,9 +1,11 @@
 {
 	"files": {
 		"includes": [
-			"{src,ve-project,ve-project2}/**/*.{ts,tsx}",
+			"{src,ve-project2}/**/*.{ts,tsx}",
 			"scripts/**/*.{js,mjs}",
-			"biome.json"
+			"biome.json",
+			"!ve-project2/src/themes",
+			"!ve-project2/src/theme-contract/_public-vars.css.ts"
 		]
 	},
 	"formatter": {
@@ -38,5 +40,17 @@
 		"formatter": {
 			"trailingCommas": "none"
 		}
-	}
+	},
+	"overrides": [
+		{
+			"includes": ["scripts/**"],
+			"linter": {
+				"rules": {
+					"suspicious": {
+						"noTemplateCurlyInString": "off"
+					}
+				}
+			}
+		}
+	]
 }

docs/changelog/2026-07-20-granular-scope-lazy-load.md

@@ -0,0 +1,90 @@
+# 2026-07-20 — Granular mode: lazy per-theme scope loading
+
+## Prompt original
+
+> When I open this page from dev server:
+> `http://localhost:5175/ui/offcanvas/default-offcanvas?style-loader=granular`
+> I see many network requests that in theory should not be needed, like scope
+> files for all themes beyond the current theme ("bootstrap" by default). They
+> seem to be loaded by Ve2Shell.tsx, but the page should only execute
+> Ve2GranularShell in theory from the url. Am I missing something?
+
+Follow-up: proceed with **Option A** (runtime-only async scope resolution), then
+document + commit + push.
+
+## O que foi implementado
+
+Em `--style-loader=granular` a página carregava os 27 `themes/*/scope.css` (um por
+tema) mesmo usando um só. Havia **duas** fontes de import estático:
+
+1. **`theme-runtime.ts`** (gerado) importava os 27 `scope.css` estaticamente para
+   montar o mapa `themeScopes`, consumido por `resolveVe2ThemeClass()` de forma
+   síncrona. Um lookup de uma chave arrastava os 27 módulos de efeito colateral.
+2. **`Ve2ShellRuntime.tsx`** importava `Ve2Shell` estaticamente; como `Ve2Shell`
+   também importa os 27 `scope.css`, o módulo do fallback carregava tudo mesmo no
+   branch granular do `<Show>` (o `<Show>` controla renderização, não import).
+
+Correções (Option A — só runtime, sem mexer no emitter/contract):
+
+- **Gerador `generate-granular-loaders.mjs`**: substituído o mapa estático
+  `themeScopes` + `resolveVe2ThemeClass` por `ve2ThemeScopeLoaders`
+  (`() => import('../themes/<t>/scope.css').then(m => m.<t>Scope)`) + a função
+  `loadVe2ThemeScope()`. `theme-runtime.ts` regenerado.
+- **`Ve2GranularShell.tsx`**: resolve a scope class de forma assíncrona via
+  `createEffect(themeKey, …)` (forma de 2 args do Solid 2.0) para um signal, com
+  guarda de resolução obsoleta, e só renderiza a subárvore atrás de `<Show>`
+  quando o único `scope.css` do tema ativo carrega. Espelha o padrão `themeReady`
+  já existente em `Ve2Shell`.
+- **`Ve2ShellRuntime.tsx`**: `Ve2Shell` agora é `lazy()`, então os 27 imports de
+  scope só carregam quando o modo theme/literal é realmente usado.
+
+Detalhe do Solid: a versão do projeto é **solid-js 2.0.0-beta.7**, onde `on` e
+`createResource` não existem e escrever signal síncrono dentro de
+`createRenderEffect` viola `SIGNAL_WRITE_IN_OWNED_SCOPE`. A forma de 2 args do
+`createEffect(source, effectFn)` roda o callback fora do escopo "owned", que é o
+que permite o write — como já fazia o `Ve2Shell`.
+
+## Antes / depois
+
+Requests de `scope.css` na rota `/ui/offcanvas/default-offcanvas`:
+
+| Página | Antes | Depois |
+|---|---:|---:|
+| granular (bootstrap) | 27 | **1** (`bootstrap`) |
+| granular (`&theme=darkly`) | 27 | **1** (`darkly`) |
+| theme mode (inalterado) | 27 | 27 |
+
+Theme/literal mode continua carregando 27 — é o caminho do monólito `Ve2Shell`,
+fora do escopo desta correção.
+
+## Como foi testado
+
+Verificação funcional via Playwright contra um dev server limpo (porta alternativa,
+pois o do usuário estava com deps otimizadas defasadas):
+
+- Contou requests casando `/themes/<t>/scope.css` por rota.
+- Asseverou que `.bd-example` renderiza (scope aplicado) e que não há `pageerror`.
+- Resultado: granular default → 1 scope; granular `&theme=darkly` → 1 scope
+  (darkly, troca de tema funciona); theme mode → 27; todos renderizam, 0 erros.
+
+`biome check` limpo nos arquivos alterados. `tsc` sem erros nos arquivos alterados
+(os ~11k erros do `tsc` raiz são ruído pré-existente do monorepo: `node_modules`
+do astro e `.css.ts` do vanilla-extract sob o tsconfig raiz frouxo).
+
+## Testes criados/alterados
+
+Nenhum teste automatizado permanente adicionado — a verificação foi um script
+Playwright descartável (o projeto verifica o caminho granular pela suíte de
+screenshots `capture-leaf-screenshots.mjs`, não por unit tests de runtime). O
+invariante contínuo é a métrica de contagem de scope requests descrita acima.
+
+## Arquivos
+
+- `scripts/generate-ve-theme/generate-granular-loaders.mjs`
+- `ve-project2/src/theme-runtime/theme-runtime.ts` (regenerado)
+- `ve-project2/src/components/shell/Ve2GranularShell.tsx`
+- `ve-project2/src/components/shell/Ve2ShellRuntime.tsx`
+
+> Nota: `ve-project2/index.html` aparece como modificado no working tree, mas é uma
+> mudança **pré-existente** a esta sessão (reordenação dos `<link>` de fontes para
+> dentro do `<head>`), não incluída neste commit.