@oktis-works/cms 0.1.13 → 0.2.0

package/dist/redeploy.js

@@ -0,0 +1,363 @@
+// @oktis-works/cms - `okcms redeploy` (F4)
+//
+// Instalar plugin/tema no host ainda não muda o que está no ar:
+//
+//   plugins e temas entram na imagem pelo `COPY . .` do Dockerfile (o
+//   `.dockerignore` os preserva de propósito) — sem rebuild, o container segue
+//   servindo a cópia antiga;
+//
+//   `themes/<n>/dist/theme.css` só existe se o build de estilo rodou no host:
+//   o web linka esse arquivo pronto, ele não é compilado dentro do container;
+//
+//   um plugin que mexe no banco traz SQL em `plugins/<n>/migrations/`, que
+//   precisa chegar em `migrations/` para o `db:migrate` aplicá-lo — o runner
+//   só lê UM diretório e classifica como PLUGIN todo owner que não é `core`
+//   (`V###__owner__nome.sql`, rastreado por `owner:version`).
+//
+// Redeploy = preparar no host (stage do SQL + build dos temas) e então
+// delegar a troca ao mesmo blue/green do `okcms update --mode deploy`, só que
+// sem `bun add`: o que mudou é conteúdo de extensão, não versão de pacote.
+//
+// Ordem e garantias são as do deploy normal: falha no preparo = nada foi
+// buildado nem trocado; falha no deploy = rollback e a lane que estava
+// servindo continua servindo.
+import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { deployBlueGreen } from './bluegreen.js';
+import { assertHostOnly } from './guards.js';
+import { loadProjectConfig } from './project-config.js';
+import { Prompt } from './prompt.js';
+import { buildThemeStylesOnDisk, resolveThemeStyle, themeManifestPath, } from './theme-build.js';
+import { resolveDeployChoices } from './update.js';
+/**
+ * Mesmo padrão de `parseMigrationName` (packages/database): qualquer `.sql`
+ * fora dele derruba `loadMigrationsFromDir` para TODAS as migrations do
+ * diretório — por isso nada fora do padrão é copiado para `migrations/`.
+ */
+export const MIGRATION_FILENAME = /^V\d+__\w+__.+\.sql$/;
+function listDirs(dir) {
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .sort();
+}
+function listSql(dir) {
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir)
+        .filter((file) => file.endsWith('.sql'))
+        .sort();
+}
+function sameContent(a, b) {
+    try {
+        return readFileSync(a, 'utf-8') === readFileSync(b, 'utf-8');
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Lê o estado de plugins/temas e devolve o que o redeploy faria. Só lê —
+ * nenhum byte é escrito aqui, o que torna `--dry-run` e os testes triviais.
+ */
+export function planRedeploy(opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    const config = loadProjectConfig(cwd);
+    const pluginsDir = join(cwd, config.pluginsDir);
+    const themesDir = join(cwd, config.themesDir);
+    const migrationsDir = opts.migrationsDir ?? join(cwd, 'migrations');
+    const plugins = listDirs(pluginsDir);
+    const themes = listDirs(themesDir);
+    // ---- migrations de plugin ------------------------------------------------
+    const migrations = [];
+    const scopedPlugins = opts.plugin ? plugins.filter((name) => name === opts.plugin) : plugins;
+    for (const plugin of scopedPlugins) {
+        const dir = join(pluginsDir, plugin, 'migrations');
+        for (const file of listSql(dir)) {
+            const source = join(dir, file);
+            const target = join(migrationsDir, file);
+            let status;
+            if (!MIGRATION_FILENAME.test(file))
+                status = 'invalid';
+            else if (!existsSync(target))
+                status = 'new';
+            else if (sameContent(source, target))
+                status = 'staged';
+            else
+                status = 'conflict';
+            migrations.push({ plugin, file, source, target, status });
+        }
+    }
+    // ---- build de tema -------------------------------------------------------
+    const themeBuilds = [];
+    const scopedThemes = opts.theme ? themes.filter((name) => name === opts.theme) : themes;
+    for (const theme of scopedThemes) {
+        const manifestPath = themeManifestPath(themesDir, theme);
+        if (!manifestPath) {
+            themeBuilds.push({
+                theme,
+                manifestPath: null,
+                engine: '-',
+                output: 'dist/theme.css',
+                entry: null,
+                status: 'missing-manifest',
+                problems: [],
+            });
+            continue;
+        }
+        const resolved = resolveThemeStyle(themesDir, theme);
+        if (!resolved) {
+            themeBuilds.push({
+                theme,
+                manifestPath,
+                engine: '-',
+                output: 'dist/theme.css',
+                entry: null,
+                status: 'invalid-manifest',
+                problems: ['manifesto não é um JSON válido'],
+            });
+            continue;
+        }
+        // O ThemeLoader recusa manifesto sem name/version — buildar seria trabalho
+        // jogado fora.
+        const problems = [];
+        if (typeof resolved.manifest['name'] !== 'string' ||
+            typeof resolved.manifest['version'] !== 'string') {
+            problems.push('manifesto sem "name" e/ou "version"');
+        }
+        problems.push(...resolved.report.errors);
+        const { report } = resolved;
+        themeBuilds.push({
+            theme,
+            manifestPath,
+            engine: report.engine,
+            output: report.output,
+            entry: report.entry,
+            status: problems.length > 0 ? 'invalid-manifest' : report.entry ? 'build' : 'no-entry',
+            problems,
+        });
+    }
+    // ---- higiene do diretório canônico de migrations --------------------------
+    const invalidExisting = listSql(migrationsDir).filter((file) => !MIGRATION_FILENAME.test(file));
+    return { plugins, themes, migrations, themeBuilds, invalidExisting };
+}
+/**
+ * Copia o SQL de plugin para `migrations/` (o único diretório que o runner
+ * lê). Idempotente: arquivo idêntico não é tocado, arquivo divergente é
+ * PRESERVADO — `migrations/` pertence ao operador e a versão aplicada no
+ * banco já tem checksum registrado.
+ */
+export function stagePluginMigrations(plan) {
+    const result = { copied: [], already: [], conflicts: [], invalid: [] };
+    for (const entry of plan.migrations) {
+        if (entry.status === 'invalid') {
+            result.invalid.push(`${entry.plugin}: ${entry.file}`);
+            continue;
+        }
+        if (entry.status === 'conflict') {
+            result.conflicts.push(`${entry.plugin}: ${entry.file}`);
+            continue;
+        }
+        if (entry.status === 'staged') {
+            result.already.push(`${entry.plugin}: ${entry.file}`);
+            continue;
+        }
+        mkdirSync(dirname(entry.target), { recursive: true });
+        copyFileSync(entry.source, entry.target);
+        result.copied.push(`${entry.plugin}: ${entry.file}`);
+    }
+    return result;
+}
+/** Linhas do resumo do redeploy — puras, para `--dry-run` e para os testes. */
+export function renderPlan(plan, opts = {}) {
+    const lines = [];
+    lines.push(`plugins: ${plan.plugins.length > 0 ? plan.plugins.join(', ') : 'nenhum'}`);
+    lines.push(`temas: ${plan.themes.length > 0 ? plan.themes.join(', ') : 'nenhum'}`);
+    if (opts.skipMigrations) {
+        lines.push('migrations de plugin: puladas (--skip-migrations)');
+    }
+    else if (plan.migrations.length === 0) {
+        lines.push('migrations de plugin: nenhuma');
+    }
+    else {
+        lines.push('migrations de plugin (plugins/*/migrations → migrations/):');
+        for (const entry of plan.migrations) {
+            const who = `${entry.plugin}: ${entry.file}`;
+            if (entry.status === 'new')
+                lines.push(`  + ${who} → migrations/ (novo)`);
+            else if (entry.status === 'staged')
+                lines.push(`  = ${who} (já em migrations/)`);
+            else if (entry.status === 'conflict')
+                lines.push(`  ! ${who} difere do que já está em migrations/ — mantido o do projeto`);
+            else
+                lines.push(`  ! ${who} fora do padrão V###__owner__nome.sql — não copiado`);
+        }
+    }
+    if (opts.skipThemeBuild) {
+        lines.push('build de tema: pulado (--skip-theme-build)');
+    }
+    else if (plan.themeBuilds.length === 0) {
+        lines.push('build de tema: nenhum tema instalado');
+    }
+    else {
+        lines.push('build de tema:');
+        for (const entry of plan.themeBuilds) {
+            if (entry.status === 'build') {
+                lines.push(`  ✓ ${entry.theme} — ${entry.engine} → ${entry.output}`);
+            }
+            else if (entry.status === 'no-entry') {
+                lines.push(`  - ${entry.theme} — sem entrada de estilo (${entry.engine})`);
+            }
+            else if (entry.status === 'missing-manifest') {
+                lines.push(`  ! ${entry.theme} — sem theme.json`);
+            }
+            else {
+                lines.push(`  ! ${entry.theme} — manifest recusado: ${entry.problems.join('; ')}`);
+            }
+        }
+    }
+    for (const file of plan.invalidExisting) {
+        lines.push(`  ! migrations/${file} fora do padrão V###__owner__nome.sql — quebra todo db:migrate`);
+    }
+    lines.push('ordem: stage no host → build da imagem → migrations → health → swap → worker → down');
+    return lines;
+}
+export async function runRedeploy(opts = {}) {
+    const prompt = opts.prompt ?? new Prompt();
+    const ownsPrompt = opts.prompt === undefined;
+    const cwd = opts.cwd ?? process.cwd();
+    const write = opts.log ?? ((message) => prompt.write(message));
+    // Mesmo motivo do `okcms update`: dentro de um container a CLI viraria um
+    // executor de `bun add` na rede do banco, com o .env na mão.
+    const guard = assertHostOnly('okcms redeploy', { force: opts.force, probe: opts.probe });
+    if (!guard.ok) {
+        console.error(guard.message);
+        if (ownsPrompt)
+            prompt.close();
+        return 1;
+    }
+    const onInterrupt = () => {
+        prompt.write(`\n  interrompido — nenhuma troca de lane em andamento foi registrada.\n`);
+        process.exit(130);
+    };
+    process.once('SIGINT', onInterrupt);
+    try {
+        const plan = planRedeploy({ cwd, plugin: opts.plugin, theme: opts.theme });
+        const config = loadProjectConfig(cwd);
+        const themesDir = join(cwd, config.themesDir);
+        if (opts.plugin && !plan.plugins.includes(opts.plugin)) {
+            prompt.error(`plugin não encontrado: ${opts.plugin}`);
+            prompt.info(`instalados: ${plan.plugins.join(', ') || 'nenhum'}`);
+            return 1;
+        }
+        if (opts.theme && !plan.themes.includes(opts.theme)) {
+            prompt.error(`tema não encontrado: ${opts.theme}`);
+            prompt.info(`instalados: ${plan.themes.join(', ') || 'nenhum'}`);
+            return 1;
+        }
+        prompt.heading('OkCMS redeploy');
+        for (const line of renderPlan(plan, opts))
+            write(`${line}\n`);
+        // `.sql` inválido em migrations/ derruba o `db:migrate` do passo 5 do
+        // deploy. Falhar aqui é melhor que falhar no meio do blue/green.
+        if (plan.invalidExisting.length > 0) {
+            prompt.error(`${plan.invalidExisting.length} arquivo(s) em migrations/ fora do padrão ` +
+                `V###__owner__nome.sql — o db:migrate falharia. Renomeie ou remova.`);
+            return 1;
+        }
+        if (opts.dryRun) {
+            prompt.info('dry-run: nada foi executado.');
+            return 0;
+        }
+        const choices = await resolveDeployChoices(opts, prompt);
+        const interactive = prompt.interactive && opts.yes !== true;
+        if (interactive) {
+            prompt.heading('Resumo do redeploy');
+            prompt.info(`stage: ${plan.migrations.filter((m) => m.status === 'new').length} migration(s) de plugin`);
+            prompt.info(`build de estilo: ${plan.themeBuilds.filter((t) => t.status === 'build').length} tema(s)`);
+            prompt.info(`imagem: ${choices.noCache ? 'sem cache' : 'com cache de camadas'}`);
+            prompt.info(`órfãos da lane antiga: ${choices.removeOrphans ? 'remover' : 'manter'}`);
+            const confirmed = await prompt.confirm('Iniciar redeploy?', { defaultValue: true });
+            if (!confirmed) {
+                prompt.warn('cancelado — nada foi executado.');
+                return 0;
+            }
+        }
+        // ---- stage de migrations ----------------------------------------------
+        if (opts.skipMigrations) {
+            const pending = plan.migrations.filter((m) => m.status === 'new').length;
+            if (pending > 0) {
+                prompt.warn(`${pending} migration(s) de plugin não copiadas (--skip-migrations).`);
+            }
+        }
+        else {
+            const staged = stagePluginMigrations(plan);
+            for (const item of staged.copied)
+                write(`  + migrations: ${item}\n`);
+            if (staged.copied.length > 0) {
+                prompt.success(`${staged.copied.length} migration(s) de plugin em migrations/`);
+            }
+            for (const item of staged.conflicts)
+                prompt.warn(`conflito (mantido o do projeto): ${item}`);
+            for (const item of staged.invalid)
+                prompt.warn(`fora do padrão, não copiada: ${item}`);
+        }
+        // ---- build de estilo ---------------------------------------------------
+        const toBuild = plan.themeBuilds.filter((entry) => entry.status === 'build');
+        if (opts.skipThemeBuild) {
+            if (toBuild.length > 0) {
+                prompt.warn(`${toBuild.length} tema(s) sem build de estilo (--skip-theme-build).`);
+            }
+        }
+        else {
+            for (const entry of toBuild) {
+                try {
+                    const outcome = await buildThemeStylesOnDisk(themesDir, entry.theme);
+                    for (const warning of outcome.warnings)
+                        prompt.warn(`${entry.theme}: ${warning}`);
+                    write(`  ✓ tema ${outcome.theme}: ${outcome.engine} → ${outcome.output} ` +
+                        `(${outcome.bytes} bytes, isolated=${outcome.isolated})\n`);
+                }
+                catch (error) {
+                    prompt.error(`build do tema ${entry.theme} falhou: ${error instanceof Error ? error.message : String(error)}`);
+                    prompt.warn('nada foi buildado nem trocado — a lane atual segue no ar.');
+                    return 1;
+                }
+            }
+            for (const entry of plan.themeBuilds) {
+                if (entry.status === 'missing-manifest') {
+                    prompt.warn(`${entry.theme}: sem theme.json — ignorado.`);
+                }
+                else if (entry.status === 'invalid-manifest') {
+                    prompt.warn(`${entry.theme}: manifest recusado — ${entry.problems.join('; ')}`);
+                }
+            }
+        }
+        // ---- deploy blue/green -------------------------------------------------
+        const result = await deployBlueGreen({
+            cwd,
+            runner: opts.runner,
+            choices,
+            // Sem `bun add`: o que mudou é conteúdo de extensão, não versão de
+            // pacote. Só instala tudo quando o host nem tem node_modules — sem ele
+            // o `db:migrate` do passo 5 não tem como rodar.
+            packages: [],
+            installAll: !existsSync(join(cwd, 'node_modules', '@oktis-works')),
+            log: write,
+            warn: write,
+        });
+        if (result.ok) {
+            prompt.success(`redeploy concluído na lane ${result.lane}` +
+                (result.previousLane ? ` (lane anterior: ${result.previousLane})` : ''));
+        }
+        return result.ok ? 0 : 1;
+    }
+    finally {
+        process.removeListener('SIGINT', onInterrupt);
+        if (ownsPrompt)
+            prompt.close();
+    }
+}
+//# sourceMappingURL=redeploy.js.map

package/dist/redeploy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redeploy.js","sourceRoot":"","sources":["../src/redeploy.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,EAAE;AACF,gEAAgE;AAChE,EAAE;AACF,sEAAsE;AACtE,+EAA+E;AAC/E,6BAA6B;AAC7B,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,EAAE;AACF,2EAA2E;AAC3E,6EAA6E;AAC7E,4EAA4E;AAC5E,8DAA8D;AAC9D,EAAE;AACF,uEAAuE;AACvE,8EAA8E;AAC9E,2EAA2E;AAC3E,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AACvE,8BAA8B;AAE9B,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,eAAe,EAAsB,MAAM,gBAAgB,CAAC;AAErE,OAAO,EAAE,cAAc,EAAuB,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AA0DzD,SAAS,QAAQ,CAAC,GAAW;IAC3B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,OAAO,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SAC7C,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;SACtC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;SAC1B,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,OAAO,CAAC,GAAW;IAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,OAAO,WAAW,CAAC,GAAG,CAAC;SACpB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;SACvC,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,WAAW,CAAC,CAAS,EAAE,CAAS;IACvC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,OAA4B,EAAE;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAEpE,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAEnC,6EAA6E;IAC7E,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAE7F,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;QACnD,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;YACzC,IAAI,MAAsC,CAAC;YAC3C,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,MAAM,GAAG,SAAS,CAAC;iBAClD,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,MAAM,GAAG,KAAK,CAAC;iBACxC,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC;gBAAE,MAAM,GAAG,QAAQ,CAAC;;gBACnD,MAAM,GAAG,UAAU,CAAC;YACzB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,MAAM,WAAW,GAAsB,EAAE,CAAC;IAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAExF,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QACjC,MAAM,YAAY,GAAG,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACzD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,WAAW,CAAC,IAAI,CAAC;gBACf,KAAK;gBACL,YAAY,EAAE,IAAI;gBAClB,MAAM,EAAE,GAAG;gBACX,MAAM,EAAE,gBAAgB;gBACxB,KAAK,EAAE,IAAI;gBACX,MAAM,EAAE,kBAAkB;gBAC1B,QAAQ,EAAE,EAAE;aACb,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,WAAW,CAAC,IAAI,CAAC;gBACf,KAAK;gBACL,YAAY;gBACZ,MAAM,EAAE,GAAG;gBACX,MAAM,EAAE,gBAAgB;gBACxB,KAAK,EAAE,IAAI;gBACX,MAAM,EAAE,kBAAkB;gBAC1B,QAAQ,EAAE,CAAC,gCAAgC,CAAC;aAC7C,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,2EAA2E;QAC3E,eAAe;QACf,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IACE,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,QAAQ;YAC7C,OAAO,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,QAAQ,EAChD,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;QACvD,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAEzC,MAAM,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;QAC5B,WAAW,CAAC,IAAI,CAAC;YACf,KAAK;YACL,YAAY;YACZ,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU;YACtF,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAED,8EAA8E;IAC9E,MAAM,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAEhG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;AACvE,CAAC;AAaD;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAkB;IACtD,MAAM,MAAM,GAAgB,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAEpF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACtD,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAChC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACxD,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACtD,SAAS;QACX,CAAC;QACD,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtD,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAWD,+EAA+E;AAC/E,MAAM,UAAU,UAAU,CAAC,IAAkB,EAAE,OAA0B,EAAE;IACzE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvF,KAAK,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEnF,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IAClE,CAAC;SAAM,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC9C,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QACzE,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpC,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;YAC7C,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,uBAAuB,CAAC,CAAC;iBACrE,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,sBAAsB,CAAC,CAAC;iBAC5E,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU;gBAClC,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,8DAA8D,CAAC,CAAC;;gBAClF,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,qDAAqD,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;IAC3D,CAAC;SAAM,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACrD,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrC,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBAC7B,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,KAAK,MAAM,KAAK,CAAC,MAAM,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YACvE,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBACvC,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,KAAK,6BAA6B,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;YAC7E,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,KAAK,kBAAkB,EAAE,CAAC;gBAC/C,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,KAAK,mBAAmB,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,KAAK,yBAAyB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACrF,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,gEAAgE,CAAC,CAAC;IACrG,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,qFAAqF,CAAC,CAAC;IAElG,OAAO,KAAK,CAAC;AACf,CAAC;AAiCD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAwB,EAAE;IAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,OAAe,EAAQ,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAE7E,0EAA0E;IAC1E,6DAA6D;IAC7D,MAAM,KAAK,GAAG,cAAc,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACzF,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,UAAU;YAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QAC/B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,WAAW,GAAG,GAAS,EAAE;QAC7B,MAAM,CAAC,KAAK,CAAC,yEAAyE,CAAC,CAAC;QACxF,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAEpC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,YAAY,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3E,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAE9C,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACvD,MAAM,CAAC,KAAK,CAAC,0BAA0B,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACtD,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;YAClE,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,CAAC,KAAK,CAAC,wBAAwB,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACnD,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;YACjE,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACjC,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC;YAAE,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;QAE9D,sEAAsE;QACtE,iEAAiE;QACjE,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,MAAM,CAAC,KAAK,CACV,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,4CAA4C;gBACxE,oEAAoE,CACvE,CAAC;YACF,OAAO,CAAC,CAAC;QACX,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC5C,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,OAAO,GAAkB,MAAM,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACxE,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC;QAE5D,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;YACrC,MAAM,CAAC,IAAI,CACT,UAAU,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,MAAM,yBAAyB,CAC5F,CAAC;YACF,MAAM,CAAC,IAAI,CACT,oBAAoB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,MAAM,UAAU,CAC1F,CAAC;YACF,MAAM,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,sBAAsB,EAAE,CAAC,CAAC;YACjF,MAAM,CAAC,IAAI,CAAC,0BAA0B,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;YACtF,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;YACpF,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;gBAC/C,OAAO,CAAC,CAAC;YACX,CAAC;QACH,CAAC;QAED,0EAA0E;QAC1E,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,MAAM,CAAC;YACzE,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,2DAA2D,CAAC,CAAC;YACrF,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;YAC3C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM;gBAAE,KAAK,CAAC,mBAAmB,IAAI,IAAI,CAAC,CAAC;YACrE,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,wCAAwC,CAAC,CAAC;YAClF,CAAC;YACD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,SAAS;gBAAE,MAAM,CAAC,IAAI,CAAC,oCAAoC,IAAI,EAAE,CAAC,CAAC;YAC7F,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO;gBAAE,MAAM,CAAC,IAAI,CAAC,gCAAgC,IAAI,EAAE,CAAC,CAAC;QACzF,CAAC;QAED,2EAA2E;QAC3E,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;QAC7E,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,oDAAoD,CAAC,CAAC;YACrF,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;oBACrE,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ;wBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC,CAAC;oBAClF,KAAK,CACH,YAAY,OAAO,CAAC,KAAK,KAAK,OAAO,CAAC,MAAM,MAAM,OAAO,CAAC,MAAM,GAAG;wBACjE,IAAI,OAAO,CAAC,KAAK,oBAAoB,OAAO,CAAC,QAAQ,KAAK,CAC7D,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,KAAK,CACV,iBAAiB,KAAK,CAAC,KAAK,YAC1B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE,CACH,CAAC;oBACF,MAAM,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;oBACzE,OAAO,CAAC,CAAC;gBACX,CAAC;YACH,CAAC;YACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrC,IAAI,KAAK,CAAC,MAAM,KAAK,kBAAkB,EAAE,CAAC;oBACxC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,8BAA8B,CAAC,CAAC;gBAC5D,CAAC;qBAAM,IAAI,KAAK,CAAC,MAAM,KAAK,kBAAkB,EAAE,CAAC;oBAC/C,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,yBAAyB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAClF,CAAC;YACH,CAAC;QACH,CAAC;QAED,2EAA2E;QAC3E,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;YACnC,GAAG;YACH,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,OAAO;YACP,mEAAmE;YACnE,uEAAuE;YACvE,gDAAgD;YAChD,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;YAClE,GAAG,EAAE,KAAK;YACV,IAAI,EAAE,KAAK;SACZ,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,MAAM,CAAC,OAAO,CACZ,8BAA8B,MAAM,CAAC,IAAI,EAAE;gBACzC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,oBAAoB,MAAM,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAC1E,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC9C,IAAI,UAAU;YAAE,MAAM,CAAC,KAAK,EAAE,CAAC;IACjC,CAAC;AACH,CAAC"}

package/dist/scaffold-docs.d.ts

@@ -1,7 +1,26 @@
-/** README.md do projeto scaffoldado. */
-export declare function projectReadme(projectName: string): string;
-/** PLUGIN.md — guia de desenvolvimento de plugins. */
-export declare const PLUGIN_DOC = "# Desenvolvendo um Plugin\n\nPlugin \u00E9 a extens\u00E3o que se registra no runtime do CMS e participa do sistema\nde **hooks e filters** (transformar dados, reagir a eventos de conte\u00FAdo etc.).\nO cat\u00E1logo de hooks dispon\u00EDveis \u00E9 servido pela API em\n`GET /api/v1/hooks/catalog`.\n\n> Os comandos usam `npx` com a CLI local do projeto (sem instala\u00E7\u00E3o\n> global). Com a CLI global (`bun add -g @oktis-works/cms`), rode\n> `okcms ...` direto.\n\n## Estrutura gerada\n\n```bash\nnpx okcms plugin:create --name meu-plugin\n```\n\n```\nplugins/meu-plugin/\n\u251C\u2500\u2500 manifest.json   # identidade + permiss\u00F5es + compatibilidade\n\u251C\u2500\u2500 index.js        # entrypoint: module.exports.register(registry)\n\u2514\u2500\u2500 README.md\n```\n\n### manifest.json\n\n```json\n{\n  \"name\": \"meu-plugin\",\n  \"version\": \"0.1.0\",\n  \"description\": \"Plugin meu-plugin para OkCMS\",\n  \"type\": \"plugin\",\n  \"main\": \"index.js\",\n  \"scope\": \"tenant\",\n  \"permissions\": [],\n  \"compatibility\": { \"okcms\": \"^0.1.x\" }\n}\n```\n\n| Campo | Significado |\n|---|---|\n| `type` | `\"plugin\"` (fixo \u2014 temas usam `\"theme\"`) |\n| `main` | Arquivo de entrada com o registro |\n| `scope` | Escopo de atua\u00E7\u00E3o no multi-tenant (ex.: `tenant`) |\n| `permissions` | Permiss\u00F5es que o plugin pede (vazio = nenhuma) |\n| `compatibility.okcms` | Range semver exigido do CMS. **O scaffold preenche com a vers\u00E3o atual automaticamente** e o valor \u00E9 validado no scaffold e em cada instala\u00E7\u00E3o \u2014 manifesto incompat\u00EDvel \u00E9 rejeitado. |\n\n### index.js\n\n```js\n'use strict';\n\nmodule.exports.register = function register(registry) {\n  registry.addFilter('theme:data:posts', (value) => value);\n};\n```\n\nO `register(registry)` \u00E9 chamado quando o plugin \u00E9 carregado. Use o registro\npara expor filters (transforma\u00E7\u00F5es) \u2014 veja o que existe em\n`GET /api/v1/hooks/catalog` para os nomes e contratos dispon\u00EDveis.\n\n## Fluxo de desenvolvimento\n\n```bash\n# 1. Crie (em ./plugins do projeto, ou num workspace externo com --dir)\nnpx okcms plugin:create --name meu-plugin\n\n# 2. Implemente plugins/meu-plugin/index.js\n\n# 3. Se criou FORA do projeto, instale (valida compatibilidade e copia para plugins/)\nnpx okcms plugin:install --name ../meu-plugin-fonte\n\n# 4. Gest\u00E3o\nnpx okcms plugin:list                                # instalados + status\nnpx okcms plugin:manage -n meu-plugin --info         # informa\u00E7\u00F5es do manifesto\nnpx okcms plugin:manage -n meu-plugin --disable      # desabilita (mant\u00E9m os arquivos)\nnpx okcms plugin:manage -n meu-plugin --enable       # habilita de novo\nnpx okcms plugin:manage -n meu-plugin --uninstall    # remove arquivos + registro\n\n# 5. Busca no npm (pacotes com a keyword okcms-plugin)\nnpx okcms plugin:search -q galeria\n```\n\n## Publicando\n\nEmpacote o diret\u00F3rio do plugin como pacote npm com a keyword\n`okcms-plugin` (\u00E9 o que o `okcms plugin:search` consulta) e mantenha\n`compatibility.okcms` atualizado para a linha do CMS que voc\u00EA suporta.\n";
-/** THEME.md — guia de desenvolvimento de temas. */
-export declare const THEME_DOC = "# Desenvolvendo um Tema\n\nTema \u00E9 o visual do site p\u00FAblico: **templates** (hierarquia de p\u00E1ginas) +\n**estilos**, com isolamento por `[data-theme]` para que um tema nunca vaze\nCSS para outro.\n\n> Os comandos usam `npx` com a CLI local do projeto (sem instala\u00E7\u00E3o\n> global). Com a CLI global (`bun add -g @oktis-works/cms`), rode\n> `okcms ...` direto.\n\n## Estrutura gerada\n\n```bash\nnpx okcms theme:create --name meu-tema --style css   # css | scss | tailwind\n```\n\n```\nthemes/meu-tema/\n\u251C\u2500\u2500 theme.json               # manifest (type: theme + compatibilidade)\n\u251C\u2500\u2500 templates/\n\u2502   \u251C\u2500\u2500 index.html           # listagem (home)\n\u2502   \u2514\u2500\u2500 single.html          # p\u00E1gina \u00FAnica (post/conte\u00FAdo)\n\u251C\u2500\u2500 style.css                # engine css \u2014 ou styles/main.scss \u2014 ou src/input.css\n\u2514\u2500\u2500 README.md\n```\n\n### theme.json\n\n```json\n{\n  \"name\": \"meu-tema\",\n  \"version\": \"0.1.0\",\n  \"description\": \"Tema meu-tema para OkCMS\",\n  \"type\": \"theme\",\n  \"compatibility\": { \"okcms\": \"^0.1.x\" }\n}\n```\n\nCom `--style scss` ou `--style tailwind`, o manifesto ganha tamb\u00E9m\n`stylesConfig` (`engine`, `entry`, `output`, `isolation`) apontando para a\nentrada de estilos. `compatibility.okcms` \u00E9 preenchido e validado\nautomaticamente, como nos plugins.\n\n### Templates\n\nSintaxe de template com vari\u00E1veis e la\u00E7os:\n\n```html\n<main class=\"site\">\n  {{#each posts}}\n    <article>\n      <h2>{{this.title}}</h2>\n      <p>{{this.excerpt}}</p>\n    </article>\n  {{/each}}\n</main>\n```\n\n- `templates/index.html` \u2014 listagem (ex.: `{{#each posts}}`)\n- `templates/single.html` \u2014 item individual (ex.: `{{title}}`, `{{content}}`)\n\n## Estilos por engine\n\n| `--style` | Arquivo gerado | Build |\n|---|---|---|\n| `css` (default) | `style.css` | nenhum \u2014 servido direto |\n| `scss` | `styles/main.scss` (+ `components.scss`) | `okcms theme:build -n meu-tema` |\n| `tailwind` | `src/input.css` + `tailwind.config.js` | `okcms theme:build -n meu-tema` |\n\nO build compila para `dist/theme.css` **com isolamento\n`[data-theme=\"meu-tema\"]`** (sem vazar estilos entre temas; o Tailwind j\u00E1\nsai com `preflight: false`).\n\n## Fluxo de desenvolvimento\n\n```bash\n# 1. Crie\nnpx okcms theme:create --name meu-tema --style scss\n\n# 2. Edite templates/ e estilos\n\n# 3. Compile os estilos (scss/tailwind)\nnpx okcms theme:build --name meu-tema\n\n# 4. Ative (grava activeTheme no okcms.config.json)\nnpx okcms theme:manage --name meu-tema --set-active\n#    (equivalente: ACTIVE_THEME=meu-tema no .env)\n\n# 5. Gest\u00E3o\nnpx okcms theme:list                               # instalados + status\nnpx okcms theme:manage -n meu-tema --info          # informa\u00E7\u00F5es do theme.json\nnpx okcms theme:manage -n meu-tema --disable|enable\nnpx okcms theme:manage -n meu-tema --uninstall\nnpx okcms theme:search -q blog                     # busca no npm (keyword okcms-theme)\n\n# Se criou FORA do projeto:\nnpx okcms theme:install --name ../meu-tema-fonte\n```\n\n## Publicando\n\nPublique como pacote npm com a keyword `okcms-theme` (alvo do\n`okcms theme:search`) e mantenha `compatibility.okcms` na linha suportada\ndo CMS. O `theme:build` deve ser executado no seu processo de release para\nque `dist/theme.css` v\u00E1 junto no pacote.\n";
+/** Língua da documentação gerada no scaffold. */
+export type DocsLang = 'en' | 'pt';
+/** Línguas suportadas (ordem = ordem do menu do init). */
+export declare const DOCS_LANGS: DocsLang[];
+/**
+ * Default: inglês — é o que o Enter do prompt escolhe e o único valor em
+ * modo não-interativo (CI/scripts), onde o prompt nunca aparece.
+ */
+export declare const DEFAULT_DOCS_LANG: DocsLang;
+/**
+ * Normaliza o valor de `--lang`. Devolve `null` para valor desconhecido (ou
+ * vazio): o chamador decide entre erro (flag explícita) e default (flag ausente).
+ */
+export declare function parseDocsLang(value: string | undefined | null): DocsLang | null;
+/** Rótulo legível da língua (mensagens da CLI). */
+export declare function docsLangLabel(lang: DocsLang): string;
+/**
+ * README.md do projeto scaffoldado, na língua escolhida no \`okcms init\`.
+ * Default \`en\` (Enter do prompt e único valor em modo não-interativo).
+ */
+export declare function projectReadme(projectName: string, lang?: DocsLang): string;
+/** PLUGIN.md na língua pedida. */
+export declare function pluginDoc(lang?: DocsLang): string;
+/** THEME.md na língua pedida. */
+export declare function themeDoc(lang?: DocsLang): string;
 //# sourceMappingURL=scaffold-docs.d.ts.map

package/dist/scaffold-docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold-docs.d.ts","sourceRoot":"","sources":["../src/scaffold-docs.ts"],"names":[],"mappings":"AAIA,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAsMzD;AAED,sDAAsD;AACtD,eAAO,MAAM,UAAU,4lGAwFtB,CAAC;AAEF,mDAAmD;AACnD,eAAO,MAAM,SAAS,w3GAyGrB,CAAC"}
+{"version":3,"file":"scaffold-docs.d.ts","sourceRoot":"","sources":["../src/scaffold-docs.ts"],"names":[],"mappings":"AAeA,iDAAiD;AACjD,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;AAEnC,0DAA0D;AAC1D,eAAO,MAAM,UAAU,EAAE,QAAQ,EAAiB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAe,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,CAW/E;AAED,mDAAmD;AACnD,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEpD;AAsgCD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,QAA4B,GACjC,MAAM,CAER;AAED,kCAAkC;AAClC,wBAAgB,SAAS,CAAC,IAAI,GAAE,QAA4B,GAAG,MAAM,CAEpE;AAED,iCAAiC;AACjC,wBAAgB,QAAQ,CAAC,IAAI,GAAE,QAA4B,GAAG,MAAM,CAEnE"}