STUDIO 0.3.0 / AMBIENTE LINUX OBRIGATÓRIO

Execução PHP e TypeScript

Contrato de um plugin externo

O manifesto continua usando apiVersion: 1. PHP retorna uma função; TypeScript exporta run. A função recebe um cliente do SDK e o objeto de entrada. O Studio fornece o cliente a partir das fixtures locais, valida o projeto e executa a entrada em um processo separado.

PHP, em src/plugin.php:

<?php
declare(strict_types=1);
return static function (\Forge\Client $client, array $input = []): array {
    return ['message' => 'Olá, '.($input['name'] ?? 'Titan')];
};

TypeScript, em src/plugin.ts:

import type { Client } from '@zerotrusted/forge-sdk';
export async function run(client: Client, input: { name?: string } = {}) {
  return { message: `Olá, ${input.name ?? 'Titan'}` };
}

Use Executar plugin PHP / TypeScript. No TypeScript, o Studio compila primeiro com o compilador embarcado e o tsconfig.json do projeto. O manifesto deve apontar para o JavaScript gerado, por exemplo dist/plugin.js, não para o arquivo .ts.

O resultado aparece no painel. Se o resultado tiver uma propriedade html do tipo string, esse HTML será renderizado em iframe restrito. Caso contrário, o painel mostra o resultado JSON real da função. Logs, exceções e chamadas às fixtures ficam no canal de Saída.

Configuração de execução

Um arquivo titan-studio.json pode selecionar arquivos específicos:

{
  "runtime": {
    "mode": "php-plugin",
    "entry": "src/plugin.php",
    "input": "studio.input.json",
    "fixtures": "studio.fixtures.json"
  }
}

mode aceita php-plugin, php-page ou typescript-plugin. Sem configuração, o Studio usa o runtime e a entrada do manifesto. tsconfig permite escolher outro arquivo de configuração TypeScript. Todos esses caminhos são relativos à raiz do projeto; entradas fora dela são recusadas.

O input deve ser um objeto JSON:

{ "name": "Desenvolvedor" }

O arquivo pode conter dados de teste privados; não inclua credenciais operacionais. O Studio limita o tamanho dos arquivos, do input e da resposta. Um runtime que excede o limite de execução é interrompido.

Página PHP renderizada

Para experimentar uma página PHP independente, use php-page:

{
  "runtime": {
    "mode": "php-page",
    "entry": "preview/page.php",
    "input": "studio.input.json"
  }
}

O arquivo recebe $client, $input e $manifest no contexto de execução. Ele pode emitir HTML com echo ou alternar trechos PHP/HTML. O Studio captura a saída renderizada; o navegador recebe o HTML, não o código PHP.

Isso não fornece sessão, PDO ou funções privadas do núcleo. Para um controlador nativo que depende desses recursos, use o host local real.

Dependências e atualização

O SDK embarcado fornece as bibliotecas do Titan. Dependências próprias do projeto precisam ser instaladas com Composer/npm conforme seu processo normal. O Studio não roda scripts de instalação desconhecidos automaticamente.

Depois de iniciar a execução pelo comando, salvar um arquivo do projeto dispara uma nova execução nesse painel. O TypeScript é compilado novamente; o PHP é interpretado em um novo processo. Não há preservação automática do estado em memória. Fechar o painel cancela a execução em andamento e interrompe essa atualização automática.

Código de backend roda com a conta local do usuário. O iframe restringe o HTML resultante, mas não transforma o processo PHP/Node em uma sandbox do sistema operacional. Use somente projetos confiáveis ou isole o host de desenvolvimento inteiro.