termo_core 0.1.7 → 0.1.9

package/dist/miro/rotas.d.ts

@@ -26,6 +26,23 @@ export interface ParametrosDeBuscarPeloFiltroBoard {
     favoritos?: boolean;
     dono_id?: string;
 }
+/**
+ * Parâmetros de consulta e de cabeçalho de `/board/{id}/elementos`.
+ */
+export interface ParametrosDeElementosListarBoard {
+    /**
+     * Só os elementos deste tipo.
+     */
+    tipo?: string;
+    /**
+     * Só os elementos dentro deste frame (pelo id).
+     */
+    frame?: string;
+    /**
+     * Trecho do texto, da descrição ou de uma célula, sem diferenciar maiúsculas.
+     */
+    busca?: string;
+}
 /**
  * Lista os boards paginados
  *
@@ -37,7 +54,7 @@ export declare function buscar_paginador_board(credencial_de_acesso: CredencialD
 /**
  * Cria um board
  *
- * Livre para todo colaborador logado; quem cria é o dono. `nome` é obrigatório (até 120 caracteres), `descricao` vai até 500, `cor` segue o formato `#00397c` (padrão `#00397c`) e `visibilidade` é `ORGANIZACAO` (padrão, todos veem e editam) ou `MEMBROS` (só o dono e os `membro_ids`). O canvas nasce vazio e é editado em tempo real em `GET /board/ws/{id}?token=<JWT>` (WebSocket no protocolo do Yjs).
+ * Livre para todo colaborador logado; quem cria é o dono. `nome` é obrigatório (até 120 caracteres), `descricao` vai até 5000, `cor` segue o formato `#00397c` (padrão `#00397c`) e `visibilidade` é `ORGANIZACAO` (padrão, todos veem e editam) ou `MEMBROS` (só o dono e os `membro_ids`). O canvas nasce vazio. Para ler e editar o que fica dentro do board (notas, textos, formas, conectores, cards, tabelas, frames, imagens e traços) use as rotas `/board/{id}/elementos` (listar, criar, atualizar, excluir e organizar); a tela edita o mesmo canvas em tempo real em `GET /board/ws/{id}?token=<JWT>` (WebSocket no protocolo do Yjs), e o que a API muda aparece na hora para quem está com o board aberto.
  *
  * `POST /board`
  */
@@ -98,6 +115,59 @@ export declare function deletar_pelo_id_board(credencial_de_acesso: CredencialDe
  * `POST /board/{id}/duplicar`
  */
 export declare function duplicar_board(credencial_de_acesso: CredencialDeAcesso, id: string, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.Board>;
+/**
+ * Lista os elementos do canvas de um board
+ *
+ * Tudo o que está dentro do board, na ordem de desenho (frames primeiro, depois do `z` menor para o maior), com `limites` (a caixa que contém tudo; use para saber onde há espaço livre). Coordenadas em px do canvas: `x` cresce para a direita, `y` para baixo, e (`x`, `y`) é o canto de cima à esquerda da caixa `w` x `h`. Filtros: `tipo`, `frame` (só o que está dentro daquele frame) e `busca` (trecho do texto, da descrição ou de uma célula). Leia antes de alterar para conhecer os ids e as posições.
+ *
+ * `GET /board/{id}/elementos`
+ */
+export declare function elementos_listar_board(credencial_de_acesso: CredencialDeAcesso, id: string, parametros?: ParametrosDeElementosListarBoard, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ConteudoDoBoard>;
+/**
+ * Cria elementos no canvas de um board
+ *
+ * Cria de 1 a 500 elementos de uma vez (o que a pessoa faz com as ferramentas da tela), e quem está com o board aberto vê na hora. Só `tipo` é obrigatório; o resto vem do padrão do tipo.
+ *
+ * Tipos e padrões (w x h em px):
+ * - `sticky` (nota adesiva, 200x200, `cor` #fff9b1; a letra diminui sozinha até o `texto` caber);
+ * - `texto` (texto solto sem fundo, `tamanhoFonte` 24; sem `w`/`h`, o tamanho é medido pelo texto);
+ * - `forma` (200x120, `forma`: retangulo, arredondado, elipse, losango, triangulo, paralelogramo, hexagono, cilindro ou seta; `texto` centralizado, `cor` de fundo, `corBorda`, `espessura`);
+ * - `card` (320x160: `texto` é o título, `descricao` o corpo, `cor` a faixa lateral, `concluido`);
+ * - `tabela` (480 de largura, `linhas`: matriz de textos, a primeira linha é o cabeçalho; sem `h`, a altura acompanha as linhas);
+ * - `frame` (800x600, área com título em `texto` que agrupa outros elementos e fica sempre por baixo);
+ * - `conector` (linha com seta entre dois elementos: `de` e `para` com `id` do elemento e `lado` opcional cima/direita/baixo/esquerda; `estiloLinha` reta, curva ou cotovelo; `setaInicio`, `setaFim`, `tracejado`, `texto` como rótulo, `corBorda`);
+ * - `imagem` (320x240, `url` https:// ou a devolvida por `POST /board/{id}/imagem`);
+ * - `caneta` (traço livre: `pontos` [x0, y0, x1, y1, ...] relativos a (x, y), `corBorda`, `espessura`).
+ *
+ * Posição: com `x` e `y`, o elemento fica exatamente ali. Sem eles, o servidor posiciona em fileiras abaixo de tudo o que já existe, sem sobrepor. Com `frame` (id ou `chave` de um frame), o elemento entra no frame: `x`/`y` passam a ser relativos ao canto do frame e, sem eles, os elementos se arrumam em grade dentro do frame, que cresce para caber todos. `chave` é um apelido livre para outro elemento do mesmo pedido apontar para este (ex.: um conector `{"de": {"id": "inicio"}, "para": {"id": "fim"}}` ou `"frame": "custos"`). Cores: `#rrggbb` (paleta das notas: #fff9b1, #f5d128, #ffcee0, #f16c7f, #d5f692, #93d275, #a6ccf5, #6cd8fa, #c9b8f5, #ffc78f, #e6e6e6, #ffffff). A resposta traz os elementos criados com os ids, na ordem do pedido. Para arrumar o que já existe, use `POST /board/{id}/elementos/organizar`.
+ *
+ * `POST /board/{id}/elementos`
+ */
+export declare function elementos_criar_board(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ElementosCriar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ResultadoDosElementos>;
+/**
+ * Altera elementos do canvas de um board
+ *
+ * Altera de 1 a 500 elementos de uma vez pelo `id`: só os campos enviados mudam (texto, cores, tamanho, forma, células da tabela, pontas do conector etc.). Mover: `x`/`y` (posição nova) ou `dx`/`dy` (deslocamento). Redimensionar: `w`/`h`. Camadas: `z`, ou `ordem` `frente`/`tras`. Como na tela, mover um frame leva junto o que está dentro dele. `travado: true` impede a tela de mover ou apagar o elemento. O tipo não muda (exclua e crie de novo). A resposta traz os elementos como ficaram, inclusive os que andaram junto com um frame.
+ *
+ * `PATCH /board/{id}/elementos`
+ */
+export declare function elementos_atualizar_board(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ElementosAtualizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ResultadoDosElementos>;
+/**
+ * Exclui elementos do canvas de um board
+ *
+ * Exclui os `ids` informados; os conectores presos a eles saem junto (como na tela). Ids que não existem são ignorados. `todos: true` limpa o canvas inteiro. A resposta lista os ids removidos.
+ *
+ * `POST /board/{id}/elementos/excluir`
+ */
+export declare function elementos_excluir_board(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ElementosExcluir, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ResultadoDosElementos>;
+/**
+ * Organiza elementos do canvas em grade, linha ou coluna
+ *
+ * Arruma os elementos sem sobrepor: `layout` `grade` (padrão; `colunas` opcional, cada coluna com a largura do maior e cada linha com a altura do maior), `linha` ou `coluna`, com `espaco` px entre eles (padrão 40). A ordem segue `ordenar_por`: `posicao` (padrão, ordem de leitura atual), `texto` (alfabética) ou `criacao`. Sem `ids`, organiza os que estão dentro do `frame` ou, sem frame, todos os do board menos conectores e frames. O arranjo começa em `x`/`y`, dentro do `frame` (que cresce para caber) ou onde os elementos já começam. `frame_titulo` cria um frame com esse título em volta do arranjo. Os conectores acompanham sozinhos os elementos que ligam. A resposta traz os elementos como ficaram.
+ *
+ * `POST /board/{id}/elementos/organizar`
+ */
+export declare function elementos_organizar_board(credencial_de_acesso: CredencialDeAcesso, id: string, corpo_da_requisicao: tipos.ElementosOrganizar, opcoes_da_chamada?: OpcoesDaChamada): Promise<tipos.ResultadoDosElementos>;
 /**
  * Envia uma imagem para o canvas
  *

package/dist/miro/rotas.js

@@ -21,7 +21,7 @@ export function buscar_paginador_board(credencial_de_acesso, parametros = {}, op
 /**
  * Cria um board
  *
- * Livre para todo colaborador logado; quem cria é o dono. `nome` é obrigatório (até 120 caracteres), `descricao` vai até 500, `cor` segue o formato `#00397c` (padrão `#00397c`) e `visibilidade` é `ORGANIZACAO` (padrão, todos veem e editam) ou `MEMBROS` (só o dono e os `membro_ids`). O canvas nasce vazio e é editado em tempo real em `GET /board/ws/{id}?token=<JWT>` (WebSocket no protocolo do Yjs).
+ * Livre para todo colaborador logado; quem cria é o dono. `nome` é obrigatório (até 120 caracteres), `descricao` vai até 5000, `cor` segue o formato `#00397c` (padrão `#00397c`) e `visibilidade` é `ORGANIZACAO` (padrão, todos veem e editam) ou `MEMBROS` (só o dono e os `membro_ids`). O canvas nasce vazio. Para ler e editar o que fica dentro do board (notas, textos, formas, conectores, cards, tabelas, frames, imagens e traços) use as rotas `/board/{id}/elementos` (listar, criar, atualizar, excluir e organizar); a tela edita o mesmo canvas em tempo real em `GET /board/ws/{id}?token=<JWT>` (WebSocket no protocolo do Yjs), e o que a API muda aparece na hora para quem está com o board aberto.
  *
  * `POST /board`
  */
@@ -149,6 +149,104 @@ export function duplicar_board(credencial_de_acesso, id, opcoes_da_chamada) {
         formato_da_resposta: "json",
     }, opcoes_da_chamada);
 }
+/**
+ * Lista os elementos do canvas de um board
+ *
+ * Tudo o que está dentro do board, na ordem de desenho (frames primeiro, depois do `z` menor para o maior), com `limites` (a caixa que contém tudo; use para saber onde há espaço livre). Coordenadas em px do canvas: `x` cresce para a direita, `y` para baixo, e (`x`, `y`) é o canto de cima à esquerda da caixa `w` x `h`. Filtros: `tipo`, `frame` (só o que está dentro daquele frame) e `busca` (trecho do texto, da descrição ou de uma célula). Leia antes de alterar para conhecer os ids e as posições.
+ *
+ * `GET /board/{id}/elementos`
+ */
+export function elementos_listar_board(credencial_de_acesso, id, parametros = {}, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "GET",
+        caminho_da_rota: `/board/${codificar_parametro_de_caminho(id)}/elementos`,
+        credencial_de_acesso,
+        parametros_de_consulta: parametros,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Cria elementos no canvas de um board
+ *
+ * Cria de 1 a 500 elementos de uma vez (o que a pessoa faz com as ferramentas da tela), e quem está com o board aberto vê na hora. Só `tipo` é obrigatório; o resto vem do padrão do tipo.
+ *
+ * Tipos e padrões (w x h em px):
+ * - `sticky` (nota adesiva, 200x200, `cor` #fff9b1; a letra diminui sozinha até o `texto` caber);
+ * - `texto` (texto solto sem fundo, `tamanhoFonte` 24; sem `w`/`h`, o tamanho é medido pelo texto);
+ * - `forma` (200x120, `forma`: retangulo, arredondado, elipse, losango, triangulo, paralelogramo, hexagono, cilindro ou seta; `texto` centralizado, `cor` de fundo, `corBorda`, `espessura`);
+ * - `card` (320x160: `texto` é o título, `descricao` o corpo, `cor` a faixa lateral, `concluido`);
+ * - `tabela` (480 de largura, `linhas`: matriz de textos, a primeira linha é o cabeçalho; sem `h`, a altura acompanha as linhas);
+ * - `frame` (800x600, área com título em `texto` que agrupa outros elementos e fica sempre por baixo);
+ * - `conector` (linha com seta entre dois elementos: `de` e `para` com `id` do elemento e `lado` opcional cima/direita/baixo/esquerda; `estiloLinha` reta, curva ou cotovelo; `setaInicio`, `setaFim`, `tracejado`, `texto` como rótulo, `corBorda`);
+ * - `imagem` (320x240, `url` https:// ou a devolvida por `POST /board/{id}/imagem`);
+ * - `caneta` (traço livre: `pontos` [x0, y0, x1, y1, ...] relativos a (x, y), `corBorda`, `espessura`).
+ *
+ * Posição: com `x` e `y`, o elemento fica exatamente ali. Sem eles, o servidor posiciona em fileiras abaixo de tudo o que já existe, sem sobrepor. Com `frame` (id ou `chave` de um frame), o elemento entra no frame: `x`/`y` passam a ser relativos ao canto do frame e, sem eles, os elementos se arrumam em grade dentro do frame, que cresce para caber todos. `chave` é um apelido livre para outro elemento do mesmo pedido apontar para este (ex.: um conector `{"de": {"id": "inicio"}, "para": {"id": "fim"}}` ou `"frame": "custos"`). Cores: `#rrggbb` (paleta das notas: #fff9b1, #f5d128, #ffcee0, #f16c7f, #d5f692, #93d275, #a6ccf5, #6cd8fa, #c9b8f5, #ffc78f, #e6e6e6, #ffffff). A resposta traz os elementos criados com os ids, na ordem do pedido. Para arrumar o que já existe, use `POST /board/{id}/elementos/organizar`.
+ *
+ * `POST /board/{id}/elementos`
+ */
+export function elementos_criar_board(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: `/board/${codificar_parametro_de_caminho(id)}/elementos`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Altera elementos do canvas de um board
+ *
+ * Altera de 1 a 500 elementos de uma vez pelo `id`: só os campos enviados mudam (texto, cores, tamanho, forma, células da tabela, pontas do conector etc.). Mover: `x`/`y` (posição nova) ou `dx`/`dy` (deslocamento). Redimensionar: `w`/`h`. Camadas: `z`, ou `ordem` `frente`/`tras`. Como na tela, mover um frame leva junto o que está dentro dele. `travado: true` impede a tela de mover ou apagar o elemento. O tipo não muda (exclua e crie de novo). A resposta traz os elementos como ficaram, inclusive os que andaram junto com um frame.
+ *
+ * `PATCH /board/{id}/elementos`
+ */
+export function elementos_atualizar_board(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "PATCH",
+        caminho_da_rota: `/board/${codificar_parametro_de_caminho(id)}/elementos`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Exclui elementos do canvas de um board
+ *
+ * Exclui os `ids` informados; os conectores presos a eles saem junto (como na tela). Ids que não existem são ignorados. `todos: true` limpa o canvas inteiro. A resposta lista os ids removidos.
+ *
+ * `POST /board/{id}/elementos/excluir`
+ */
+export function elementos_excluir_board(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: `/board/${codificar_parametro_de_caminho(id)}/elementos/excluir`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
+/**
+ * Organiza elementos do canvas em grade, linha ou coluna
+ *
+ * Arruma os elementos sem sobrepor: `layout` `grade` (padrão; `colunas` opcional, cada coluna com a largura do maior e cada linha com a altura do maior), `linha` ou `coluna`, com `espaco` px entre eles (padrão 40). A ordem segue `ordenar_por`: `posicao` (padrão, ordem de leitura atual), `texto` (alfabética) ou `criacao`. Sem `ids`, organiza os que estão dentro do `frame` ou, sem frame, todos os do board menos conectores e frames. O arranjo começa em `x`/`y`, dentro do `frame` (que cresce para caber) ou onde os elementos já começam. `frame_titulo` cria um frame com esse título em volta do arranjo. Os conectores acompanham sozinhos os elementos que ligam. A resposta traz os elementos como ficaram.
+ *
+ * `POST /board/{id}/elementos/organizar`
+ */
+export function elementos_organizar_board(credencial_de_acesso, id, corpo_da_requisicao, opcoes_da_chamada) {
+    return chamar_servico({
+        servico: SERVICO_DESTA_API,
+        metodo_http: "POST",
+        caminho_da_rota: `/board/${codificar_parametro_de_caminho(id)}/elementos/organizar`,
+        credencial_de_acesso,
+        corpo_json: corpo_da_requisicao,
+        formato_da_resposta: "json",
+    }, opcoes_da_chamada);
+}
 /**
  * Envia uma imagem para o canvas
  *

package/dist/miro/tipos.d.ts

@@ -38,6 +38,12 @@ export interface BoardCriar {
     nome: string;
     visibilidade?: string | null;
 }
+export interface CaixaDoCanvas {
+    h: number;
+    w: number;
+    x: number;
+    y: number;
+}
 /**
  * Resumo do colaborador (id e nome) para mostrar autoria.
  */
@@ -45,6 +51,156 @@ export interface ColaboradorResumo {
     id: string;
     nome: string;
 }
+/**
+ * O canvas de um board.
+ */
+export interface ConteudoDoBoard {
+    /**
+     * Os elementos na ordem de desenho (frames primeiro, depois do `z` menor para o maior).
+     */
+    elementos: Array<ElementoBoard>;
+    limites?: CaixaDoCanvas | null;
+    total: number;
+}
+export interface ElementoAlterarParte2 {
+    /**
+     * Desloca o elemento em relação à posição atual (soma ao `x`).
+     */
+    dx?: number | null;
+    /**
+     * Desloca o elemento em relação à posição atual (soma ao `y`).
+     */
+    dy?: number | null;
+    h?: number | null;
+    id: string;
+    /**
+     * `frente` traz o elemento para a frente de todos; `tras` manda para trás de todos.
+     */
+    ordem?: string | null;
+    w?: number | null;
+    x?: number | null;
+    y?: number | null;
+    z?: number | null;
+}
+/**
+ * Mudança num elemento existente: só o que vier muda (o resto fica como está).
+ */
+export type ElementoAlterar = PropriedadesElemento & ElementoAlterarParte2;
+export interface ElementoBoardParte2 {
+    h?: number;
+    /**
+     * UUID v7 do elemento.
+     */
+    id: string;
+    /**
+     * `sticky`, `texto`, `forma`, `conector`, `imagem`, `frame`, `caneta`, `card` ou `tabela`.
+     */
+    tipo: string;
+    w?: number;
+    x?: number;
+    y?: number;
+    z?: number;
+}
+/**
+ * Um elemento do canvas. Coordenadas em px do canvas: `x` cresce para a direita, `y` para baixo,
+ * e (`x`, `y`) é o canto de cima à esquerda da caixa de `w` por `h`. `z` é a ordem de desenho
+ * (maior fica na frente; frames ficam sempre por baixo).
+ */
+export type ElementoBoard = PropriedadesElemento & ElementoBoardParte2;
+export interface ElementoNovoParte2 {
+    /**
+     * Apelido livre deste elemento dentro do pedido, para um conector (`de.id`/`para.id`) ou o
+     * `frame` de outro elemento do mesmo pedido apontar para ele antes de ele ter id.
+     */
+    chave?: string | null;
+    /**
+     * Id (ou `chave`) de um frame: o elemento entra nele. Com `frame`, `x` e `y` são relativos ao
+     * canto do frame; sem eles, os elementos se organizam em grade dentro do frame, que cresce
+     * para caber todos.
+     */
+    frame?: string | null;
+    h?: number | null;
+    /**
+     * `sticky`, `texto`, `forma`, `conector`, `imagem`, `frame`, `caneta`, `card` ou `tabela`.
+     */
+    tipo: string;
+    w?: number | null;
+    /**
+     * Canto de cima à esquerda. Sem `x` e `y`, o servidor posiciona o elemento: abaixo do que já
+     * existe no board, em fileiras, ou em grade dentro do `frame`.
+     */
+    x?: number | null;
+    y?: number | null;
+    /**
+     * Ordem de desenho; sem ela, o elemento entra na frente de todos.
+     */
+    z?: number | null;
+}
+/**
+ * Elemento a criar. Só `tipo` é obrigatório; o resto vem do padrão do tipo (o mesmo da
+ * ferramenta da tela).
+ */
+export type ElementoNovo = PropriedadesElemento & ElementoNovoParte2;
+export interface ElementosAtualizar {
+    /**
+     * De 1 a 500 mudanças.
+     */
+    elementos: Array<ElementoAlterar>;
+}
+export interface ElementosCriar {
+    /**
+     * De 1 a 500 elementos, criados na ordem.
+     */
+    elementos: Array<ElementoNovo>;
+}
+export interface ElementosExcluir {
+    /**
+     * Ids a excluir. Os conectores presos a eles saem junto.
+     */
+    ids?: Array<string> | null;
+    /**
+     * `true` apaga o canvas inteiro (ignora `ids`).
+     */
+    todos?: boolean | null;
+}
+export interface ElementosOrganizar {
+    /**
+     * Colunas da grade (padrão: a raiz quadrada da quantidade, arredondada para cima).
+     */
+    colunas?: number | null;
+    /**
+     * Espaço entre os elementos em px (padrão 40).
+     */
+    espaco?: number | null;
+    /**
+     * Id de um frame existente: o arranjo vai para dentro dele e o frame cresce para caber.
+     */
+    frame?: string | null;
+    /**
+     * Cria um frame novo com este título em volta do arranjo.
+     */
+    frame_titulo?: string | null;
+    /**
+     * Os elementos a organizar. Sem `ids`: os que estão dentro do `frame`, ou (sem frame) todos
+     * os do board menos conectores e frames.
+     */
+    ids?: Array<string> | null;
+    /**
+     * `grade` (padrão), `linha` (um ao lado do outro) ou `coluna` (um embaixo do outro).
+     */
+    layout?: string | null;
+    /**
+     * `posicao` (padrão: ordem de leitura atual, de cima para baixo e da esquerda para a direita),
+     * `texto` (ordem alfabética) ou `criacao` (do mais antigo ao mais novo).
+     */
+    ordenar_por?: string | null;
+    /**
+     * Canto de cima à esquerda do arranjo. Padrão: dentro do `frame`, ou onde os elementos já
+     * começam.
+     */
+    x?: number | null;
+    y?: number | null;
+}
 export interface ImagemEnviar {
     /**
      * O arquivo em base64 (pode vir como data URL: `data:image/png;base64,...`).
@@ -98,6 +254,110 @@ export interface PaginaBoardAutoComplete {
     tamanho: number;
     total: number;
 }
+/**
+ * A ponta de um conector: presa a um elemento (e a um lado dele, ou o mais próximo) ou solta
+ * em (x, y).
+ */
+export interface PontaConector {
+    /**
+     * Id do elemento em que a ponta fica presa. Ao criar, aceita também a `chave` de um
+     * elemento criado no mesmo pedido. Sem `id`, a ponta fica solta em (`x`, `y`).
+     */
+    id?: string | null;
+    /**
+     * Lado do elemento: `cima`, `direita`, `baixo` ou `esquerda`. Sem lado, o canvas usa o
+     * lado voltado para a outra ponta.
+     */
+    lado?: string | null;
+    x?: number;
+    y?: number;
+}
+/**
+ * O que cada tipo de elemento pode ter além da posição e do tamanho. Os nomes seguem o canvas
+ * (camelCase). Campo ausente fica como está (ou com o padrão do tipo, ao criar).
+ */
+export interface PropriedadesElemento {
+    /**
+     * `esquerda`, `centro` ou `direita`.
+     */
+    alinhamento?: string | null;
+    /**
+     * Só do `card`: marcado como concluído.
+     */
+    concluido?: boolean | null;
+    /**
+     * Cor de fundo (`#rrggbb` ou `transparent`): nota, forma, frame e a faixa do card.
+     */
+    cor?: string | null;
+    /**
+     * Cor da borda da forma, da linha do conector e do traço da caneta.
+     */
+    corBorda?: string | null;
+    /**
+     * Cor do texto (sem ela, o canvas escolhe a que dá contraste com o fundo).
+     */
+    corTexto?: string | null;
+    de?: PontaConector | null;
+    /**
+     * Só do `card`: o texto abaixo do título (até 5000 caracteres).
+     */
+    descricao?: string | null;
+    /**
+     * Espessura da linha, da borda ou do traço (0 a 50).
+     */
+    espessura?: number | null;
+    /**
+     * Só do `conector`: `reta`, `curva` (padrão) ou `cotovelo`.
+     */
+    estiloLinha?: string | null;
+    /**
+     * Só da `forma`: `retangulo`, `arredondado`, `elipse`, `losango`, `triangulo`,
+     * `paralelogramo`, `hexagono`, `cilindro` ou `seta`.
+     */
+    forma?: string | null;
+    /**
+     * Só da `tabela`: as células, linha a linha (a primeira linha é o cabeçalho). Até 200
+     * linhas e 50 colunas; linhas mais curtas são completadas com células vazias.
+     */
+    linhas?: Array<Array<string>> | null;
+    negrito?: boolean | null;
+    para?: PontaConector | null;
+    /**
+     * Só da `caneta`: pontos relativos a (x, y), em pares `[x0, y0, x1, y1, ...]`.
+     */
+    pontos?: Array<number> | null;
+    setaFim?: boolean | null;
+    setaInicio?: boolean | null;
+    /**
+     * Tamanho da letra em px (6 a 400). Na nota, a letra diminui sozinha até o texto caber.
+     */
+    tamanhoFonte?: number | null;
+    /**
+     * O texto do elemento (até 5000 caracteres): o da nota, do bloco de texto, da forma, o
+     * rótulo do conector, o título do frame e o título do card.
+     */
+    texto?: string | null;
+    tracejado?: boolean | null;
+    /**
+     * Travado: não sai do lugar nem é apagado pela tela (a API altera assim mesmo).
+     */
+    travado?: boolean | null;
+    /**
+     * Só da `imagem`: endereço `https://` (ou o `/board/imagem/{id}` devolvido por
+     * `POST /board/{id}/imagem`).
+     */
+    url?: string | null;
+}
 export interface RespostaDeErro {
     erro: string;
 }
+export interface ResultadoDosElementos {
+    /**
+     * Os elementos criados ou alterados, como ficaram (os criados na ordem do pedido).
+     */
+    elementos: Array<ElementoBoard>;
+    /**
+     * Ids dos elementos removidos.
+     */
+    removidos: Array<string>;
+}