@fayz-ai/pos 0.20.5 → 0.21.0

package/dist/screen/PlanStage.d.ts

@@ -0,0 +1,130 @@
+import { type FloorArea, type FloorTable, type Point } from './floorGeometry';
+import { type ZoneDraft, type ZoneTool } from './zoneDraft';
+import { type ZoneGeometry, type ZoneMembershipAction } from './zoneEditing';
+import { type TableTone } from './tableTone';
+export interface PlanTableView extends FloorTable {
+    label: string;
+    name?: string | null;
+    tone: TableTone;
+    seats?: number | null;
+    /** O cliente pediu a conta — ganha o anel sólido, por cima do tom. */
+    billRequested?: boolean;
+    /**
+     * Escalada DIRETAMENTE para quem está logado.
+     *
+     * O V1 desenha uma bolinha no canto e acrescenta «, escalada para você» ao
+     * rótulo. A razão está no comentário dele: *«a mesa aparece para os dois,
+     * esta é "a sua"»* — dentro da praça que o garçom atende, esta foi dada a
+     * ele por nome. Sem o ponto, as duas coisas se parecem.
+     */
+    assignedToMe?: boolean;
+    /** Quantas pessoas sentaram, no chip de cima. */
+    guests?: number | null;
+    /** O que o chip de baixo diz — o total, o tempo. */
+    info?: string | null;
+}
+/** Uma PRAÇA desenhada — a região de um garçom. */
+export interface PlanZone {
+    id: string;
+    name: string;
+    color?: string | null;
+    /** Retângulo, elipse ou mão livre — o desenho que a criou. */
+    shape?: 'rect' | 'rectangle' | 'ellipse' | 'polygon' | null;
+    posX?: number | null;
+    posY?: number | null;
+    widthM?: number | null;
+    heightM?: number | null;
+    polygon?: Array<{
+        x: number;
+        y: number;
+    }> | null;
+    /** As mesas que caem nela. */
+    tableIds?: string[];
+}
+export type PlanFocus = {
+    level: 'macro';
+} | {
+    level: 'area';
+    id: string;
+};
+export declare function PlanStage({ areas, zones, tables, activeId, onSelect, dimmedIds, focusAreaId, editing, onMoveTable, tool, onDrawZone, draftColor, selectedZoneId, onSelectZone, onUpdateZone, onRefuseZone, pickingZone, onToggleTableInZone, selectedAreaId, onSelectArea, aspect }: {
+    /** Os AMBIENTES — o chão. */
+    areas: FloorArea[];
+    /**
+     * As PRAÇAS — a região que cada garçom atende, por cima do chão.
+     *
+     * Irmãs do ambiente, não filhas: uma praça CRUZA ambientes, e por isso a
+     * geometria dela é absoluta. Translúcidas, para as mesas continuarem
+     * legíveis por baixo — a praça diz DE QUEM é a mesa, não o que ela é.
+     */
+    zones?: PlanZone[];
+    tables: PlanTableView[];
+    activeId?: string;
+    onSelect?: (t: PlanTableView) => void;
+    /** Fora do ambiente em foco: translúcidas, mas ainda clicáveis. */
+    dimmedIds?: ReadonlySet<string>;
+    /**
+     * O foco vem DE FORA — do filtro que já mora no rodapé do salão.
+     *
+     * Ele tinha trilha própria aqui em cima, e eram dois controles para a mesma
+     * pergunta: "que parte do salão eu estou vendo?". Quem manda é o de baixo,
+     * onde o polegar já está.
+     */
+    focusAreaId?: string;
+    /**
+     * MODO EDIÇÃO: a mesa passa a se arrastar em vez de abrir a comanda.
+     *
+     * O mesmo glifo, o mesmo palco e o mesmo toque — o que muda é o que o gesto
+     * significa. Duas telas separadas para ver e para mover fariam o operador
+     * conferir numa e corrigir na outra, comparando de memória.
+     */
+    editing?: boolean;
+    /** Ao soltar a mesa: o novo centro, em metros, já arredondado ao cm. */
+    onMoveTable?: (id: string, to: Point) => void;
+    /**
+     * A ferramenta de praça ARMADA, vinda da barra.
+     *
+     * Com ela ligada o palco muda de assunto: as mesas e os ambientes param de
+     * ouvir o ponteiro e uma folha transparente por cima captura o gesto. É o
+     * mesmo palco — o que muda é o que o dedo significa.
+     */
+    tool?: ZoneTool | null;
+    /** O resultado do gesto: a praça montada, ou a recusa com as palavras dela. */
+    onDrawZone?: (draft: ZoneDraft) => void;
+    /** Nome e cor com que a praça VAI nascer — o contorno já sai na cor certa. */
+    draftColor?: string;
+    /**
+     * A praça ESCOLHIDA para mexer — a que ganha as alças.
+     *
+     * Separada do foco do rodapé de propósito: aquele responde "que parte do
+     * salão eu estou vendo", este responde "em qual eu estou mexendo". Foram a
+     * mesma coisa por um momento, e aproximar numa praça punha alças nela sem
+     * ninguém ter pedido.
+     */
+    selectedZoneId?: string | null;
+    onSelectZone?: (id: string | null) => void;
+    /** Grava a geometria da praça ao fim do gesto. */
+    onUpdateZone?: (id: string, patch: Partial<ZoneGeometry>) => void;
+    /** A recusa do contorno, com a frase que explica a regra. */
+    onRefuseZone?: (reason: string) => void;
+    /**
+     * MODO «escolher mesas na planta».
+     *
+     * O palco apaga tudo menos a praça e o toque na mesa deixa de arrastar:
+     * ele inclui ou exclui. É o mesmo glifo com um terceiro significado, e o
+     * que decide é o modo — nunca o gesto.
+     */
+    pickingZone?: boolean;
+    onToggleTableInZone?: (tableId: string, how: ZoneMembershipAction) => void;
+    /**
+     * O AMBIENTE escolhido para mexer.
+     *
+     * Em edição o clique no chão deixa de aproximar e passa a SELECIONAR: o
+     * mesmo gesto, e o modo decide — como na mesa e na praça. Fora da edição
+     * ele continua aproximando, que é o que o garçom quer.
+     */
+    selectedAreaId?: string | null;
+    onSelectArea?: (id: string | null) => void;
+    aspect?: number;
+}): import("react").JSX.Element;
+//# sourceMappingURL=PlanStage.d.ts.map

package/dist/screen/PlanStage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlanStage.d.ts","sourceRoot":"","sources":["../../src/screen/PlanStage.tsx"],"names":[],"mappings":"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"}

package/dist/screen/PosScreen.d.ts

@@ -1,7 +1,19 @@
 import { type ReactNode } from 'react';
+import { type TablePatch } from './TableInspector';
 import type { DispatchStatus, PosAppConfig, PosCategory, PosItem, PosPosition, PosReservation, PosStaff } from '../app/config';
-import { type Ticket, type TicketLine, type TicketTotals } from './session';
+import { type Ticket, type TicketGuest, type TicketLine, type TicketTotals } from './session';
+import type { PaymentRow } from './paymentList';
+import { type OrderCover } from './TicketRail';
+import type { GuestDraft } from './GuestBar';
+import type { ClosedTicket } from './ClosedPanel';
+import type { FiscalSeal } from './fiscalSeal';
+import { type NewWaitlistEntry, type WaitlistEntry } from './waitlist';
 import { type PosNotice } from './Notice';
+import { type ZoneFields } from './zoneDraft';
+import type { ZoneGeometry } from './zoneEditing';
+import { type FloorScope } from './floorScope';
+import type { OutlinePatch } from './areaOutline';
+import type { ArrangementPlan } from './arrangePlan';
 /**
  * A bill at the moment the operator confirms it. Everything the app needs to
  * settle it is here, so the handler never has to reach back into the screen.
@@ -11,6 +23,56 @@ export interface PosBill {
     totals: TicketTotals;
     /** Which of `config.paymentMethods` was chosen. Never guessed. */
     paymentMethodId: string;
+    /**
+     * QUEM está pagando agora. Vazio = a comanda inteira.
+     *
+     * A tela de fechamento deixa marcar uma parte das contas, e essa escolha
+     * mudava o total À VISTA e mais nada: o gesto terminava com `onClose()` sem
+     * argumento, e quem recebia a conta cobrava sempre o valor cheio. Marcar um
+     * de quatro mostrava R$ 40 e fechava R$ 160 — sem aviso.
+     */
+    guestIds?: string[];
+    /**
+     * O que se está cobrando NESTE gesto, em centavos.
+     *
+     * `totals.totalCents` é a comanda inteira e continua aqui: quem fecha
+     * precisa saber as duas coisas — quanto a mesa deve e quanto entrou agora —
+     * para decidir se a conta zerou. Confundir as duas é fechar mesa com saldo.
+     */
+    amountCents: number;
+    /**
+     * O que a comanda AINDA DEVE, em centavos — o total menos o que já entrou.
+     *
+     * Não é `totals.totalCents`: uma mesa que já recebeu R$ 179,67 deve menos
+     * do que soma. Comparar a cobrança com o total BRUTO acusa de parcial um
+     * pagamento que na verdade quita a conta — foi o primeiro jeito que eu
+     * escrevi esta regra, e ele recusava o fechamento correto.
+     */
+    outstandingCents: number;
+    /**
+     * Para ONDE o dinheiro vai — a gaveta, o banco, o recebível do cartão.
+     *
+     * O razão precisa de um lado de débito, e ele é esta conta. Sem ela,
+     * `financial_receive_payment` recusa com "an account is required for
+     * method %" — e a recusa é justa: dinheiro que entra sem dizer onde é
+     * dinheiro que ninguém concilia.
+     */
+    accountId?: string;
+    /**
+     * Em quantas vezes. `1` é à vista, e é o que o débito sempre é.
+     *
+     * Vai ao razão junto com a forma: uma venda de 3× não é a mesma coisa que
+     * três vendas, e o recebível do cartão só bate com a maquininha se souber
+     * em quantas parcelas saiu.
+     */
+    installments?: number;
+    /**
+     * A bandeira — «Visa», «Alelo».
+     *
+     * Vai ao razão junto com a forma: a conciliação do mês separa Visa de
+     * Mastercard, e sem ela o extrato da adquirente não bate linha a linha.
+     */
+    cardBrand?: string;
 }
 export interface PosScreenProps {
     config: PosAppConfig;
@@ -19,6 +81,35 @@ export interface PosScreenProps {
     positions: PosPosition[];
     staff?: PosStaff[];
     reservations?: PosReservation[];
+    /**
+     * A fila de espera — quem chegou sem reserva.
+     *
+     * Só os ATIVOS (`waiting` e `called`). Quem sentou ou saiu não é fila: é
+     * histórico, e ele não disputa a atenção de quem está com o salão cheio.
+     */
+    waitlist?: WaitlistEntry[];
+    /** Pôr alguém na fila. Ausente, o botão «Novo» não aparece. */
+    onWaitlistAdd?: (entry: NewWaitlistEntry) => Promise<void> | void;
+    /** Chamar (e rechamar) — o banco carimba o prazo de tolerância. */
+    onWaitlistCall?: (entryId: string) => Promise<void> | void;
+    /** O grupo sentou na mesa `positionId`, na comanda `orderId`. */
+    onWaitlistSeat?: (entryId: string, positionId: string) => Promise<void> | void;
+    /** Não compareceu ao chamado. Quem decide é o anfitrião, nunca o relógio. */
+    onWaitlistNoShow?: (entryId: string) => Promise<void> | void;
+    /** O telefone já é de alguém? Ver `WaitlistEntrySheet.onLookupPhone`. */
+    onWaitlistLookupPhone?: (digits: string) => Promise<{
+        id: string;
+        name: string;
+    } | null>;
+    /**
+     * O check-in da reserva, GRAVADO.
+     *
+     * Sem ele o estado «Chegou» continua existindo, só que na memória deste
+     * terminal — que é como a tela de reservas já se comporta. Com ele, o outro
+     * terminal do balcão também vê que o grupo se apresentou, e é essa a razão
+     * de o gesto existir: duas pessoas atendendo a mesma porta.
+     */
+    onReservationArrived?: (reservationId: string) => Promise<void> | void;
     terminalName?: string;
     operatorName?: string;
     /**
@@ -31,7 +122,203 @@ export interface PosScreenProps {
      */
     operatorId?: string;
     connection?: 'online' | 'reconnecting' | 'offline';
-    onAction?: (actionId: string) => void;
+    /**
+     * Uma ação que o pacote não resolve sozinho.
+     *
+     * Vai com o CONTEXTO: sem saber de qual comanda a ação partiu, o app abriria
+     * a folha de desconto sobre "a comanda atual" e acertaria por sorte — o
+     * operador troca de mesa entre tocar o botão e a folha subir.
+     */
+    /** `guestId` só vem quando a ação foi pedida a partir de UM participante —
+     *  a pastilha de taxa ao lado do nome dele. */
+    onAction?: (actionId: string, ctx: {
+        positionId?: string;
+        ticket: Ticket;
+        guestId?: string;
+    }) => void;
+    /**
+     * Descartar uma comanda vazia, pela régua do rodapé.
+     *
+     * O pacote só oferece o gesto onde ele é seguro (comanda de R$ 0,00 e sem
+     * mesa); quem apaga no banco é o app.
+     */
+    onDiscardTicket?: (positionId: string) => void;
+    /**
+     * As pessoas da comanda ativa.
+     *
+     * Por posição, porque a seleção é DESTA mesa: escolher a Ana na mesa 3 e
+     * andar até a 5 não pode continuar lançando na Ana.
+     *
+     * O app é quem sabe: no salão são os participantes da mesa; no balcão
+     * costuma não haver nenhum, e aí a comanda volta a ser uma lista só — que é
+     * o comportamento do V1 e o certo para a fila do caixa.
+     */
+    /**
+     * Um painel que toma a COLUNA da direita — hoje a «Escala de hoje».
+     *
+     * Aberto, ele substitui a comanda e a planta continua à vista: é dela que se
+     * escolhe a praça ou a mesa a escalar. Em diálogo, o gesto exigia fechar,
+     * olhar e reabrir.
+     */
+    railPanel?: React.ReactNode;
+    /** O couvert aplicado a cada comanda — linhas da conta, por posição. */
+    coversByPosition?: Record<string, OrderCover[]>;
+    /**
+     * Repartir o couvert por participante — o lápis do V1 na linha dos totais.
+     *
+     * Recebe a comanda junto porque o escritor precisa saber em qual delas
+     * mexer, e o cartão do couvert só carrega o próprio id.
+     */
+    onEditCover?: (positionId: string, cover: OrderCover) => void;
+    /** O que já entrou em cada comanda, por pagamento. */
+    paymentsByPosition?: Record<string, PaymentRow[]>;
+    /** Abrir «Número de Pessoas» da comanda corrente. */
+    onEditGuestCount?: (positionId: string) => void;
+    /**
+     * Uma posição OCUPADA acabou de ser escolhida.
+     *
+     * Existe para o app buscar o que ainda não trouxe: a comanda de canal
+     * avulsa entra na bandeja com valor e idade, e as LINHAS dela só valem a
+     * consulta quando alguém a toca — carregar as onze abertas no boot custaria
+     * seis consultas cada.
+     */
+    onActivatePosition?: (positionId: string) => void;
+    /** As contas fechadas hoje — o que a coluna mostra sem comanda aberta. */
+    closedTickets?: ClosedTicket[];
+    /** Reabrir uma conta fechada — ver `reopen.ts`. */
+    onReopenClosed?: (t: ClosedTicket) => void;
+    closedLoading?: boolean;
+    /** Saiu nota? Por conta fechada — ver `fiscalSeal.ts`. */
+    closedSeals?: Record<string, FiscalSeal>;
+    /** A leitura fiscal falhou. O painel diz isso em vez de pintar tudo de
+     *  "sem nota": num painel que existe para apontar o que falta emitir, não
+     *  saber e saber que não são coisas diferentes. */
+    closedSealsFailed?: boolean;
+    onOpenClosed?: (id: string) => void;
+    /**
+     * O gesto de SAIR, em dois estágios.
+     *
+     * O ✕ do canto pertence ao hospedeiro e fecha o PDV inteiro. Mas quem está
+     * com a mesa 12 aberta e toca ali quase nunca quer sair do PDV: quer largar
+     * a mesa. O PDV registra aqui uma função que CONSOME o gesto quando há o que
+     * largar, e devolve `false` quando não há — e aí o hospedeiro fecha, como
+     * antes. Sem isto, um toque no canto tira o operador do caixa no meio do
+     * serviço, e voltar custa dois gestos e uma tela de carregamento.
+     */
+    registerEscape?: (fn: () => boolean) => void;
+    /**
+     * Mover uma mesa na planta. Sem isto não há «Editar planta» — o botão que
+     * abre um modo sem ação é pior que a ausência dele.
+     */
+    onMoveTable?: (id: string, to: {
+        x: number;
+        y: number;
+    }) => void | Promise<void>;
+    /** Grava um campo da ficha da mesa. Sem isto a ficha não abre. */
+    onUpdateTable?: (id: string, patch: TablePatch) => void | Promise<void>;
+    /**
+     * Cria uma PRAÇA a partir do desenho. Sem isto as três ferramentas somem.
+     *
+     * Praça não é ambiente: ela é o RECORTE de atendimento, desenhado por cima
+     * do chão, e pode cruzar dois ambientes. O vocabulário é contrato — foi
+     * chamar uma de outra que fez a casa batizar os ambientes de «Praça 1».
+     */
+    onCreateZone?: (fields: ZoneFields) => void | Promise<void>;
+    /** Grava a geometria de uma praça já desenhada — mover, esticar, reformar. */
+    onUpdateZone?: (id: string, patch: Partial<ZoneGeometry>) => void | Promise<void>;
+    /** Põe ou tira uma mesa da praça, à mão. */
+    onTogglaMesaNaPraca?: (zoneId: string, tableId: string, how: 'include' | 'exclude' | 'reset') => void;
+    /** Apaga a praça. As mesas ficam; o que se perde é o recorte. */
+    onDeleteZone?: (id: string) => void | Promise<void>;
+    /**
+     * Aplica o plano de «Organizar automaticamente».
+     *
+     * Vai em LOTE de propósito: cem mesas em cem chamadas fariam o salão andar
+     * a conta-gotas na tela e deixariam o banco num meio-termo se uma falhasse.
+     */
+    onArrange?: (plan: ArrangementPlan) => void | Promise<void>;
+    /**
+     * Grava a ficha e o contorno do AMBIENTE — a parede, não o recorte.
+     *
+     * Nunca leva unidade nem inquilino: o V1 conta que um campo a mais no
+     * update carregou um salão inteiro, com as mesas dentro, para a unidade que
+     * estava selecionada no topo da tela.
+     */
+    onUpdateArea?: (id: string, patch: Partial<OutlinePatch>) => void | Promise<void>;
+    /**
+     * De quem são estas mesas — a escala vigente de quem está logado.
+     *
+     * Sem ficha de pessoa (`staffId` nulo) a tela não mostra aviso nenhum: não
+     * há escala possível, e um aviso em toda tela seria ruído.
+     */
+    floorScope?: FloorScope | null;
+    /**
+     * A porta para o CADASTRO de mesas — número, lugares, criar em lote.
+     *
+     * O V1 a põe ao lado do `Simplificada | Planta baixa`, atrás de
+     * `restaurant_tables_admin`. Aqui ela só existe quando o app manda o
+     * atalho: quem decide a permissão é quem a conhece, e um botão que aparece
+     * para negar depois é pior que a ausência dele.
+     *
+     * É diferente de «Editar planta»: lá se ARRUMA o salão desenhado, aqui se
+     * CADASTRA a mesa que ainda não existe.
+     */
+    onConfigureTables?: () => void;
+    /**
+     * Um controle do app na barra da PLANTA — hoje o "Escala de hoje".
+     *
+     * Vive aqui e não numa ação da comanda porque a pergunta é do salão, não da
+     * conta: "de quem é aquela mesa?" se responde olhando a planta.
+     */
+    floorTool?: React.ReactNode;
+    /**
+     * A planta vira um SELETOR.
+     *
+     * Com a escala aberta, tocar uma mesa escolhe o alvo em vez de abrir a
+     * comanda — é o gesto do V1, e é mais direto do que procurar um nome entre
+     * duzentos numa lista.
+     */
+    shiftMode?: boolean;
+    onPickTarget?: (t: {
+        kind: 'area' | 'table';
+        id: string;
+        label: string;
+    }) => void;
+    /** Chamado quando a tela sai do modo em que o painel da escala faz sentido. */
+    onCloseShift?: () => void;
+    parties?: Record<string, TicketGuest[]>;
+    /**
+     * A taxa DESTA comanda, quando ela difere da política da casa.
+     *
+     * A casa tem uma taxa; a mesa pode ter a sua, combinada na hora. O rodapé
+     * precisa da taxa da MESA — com a da casa ele mostrava R$ 74,00 numa conta
+     * que o banco já tinha fechado em R$ 83,62, e a diferença é o que o cliente
+     * vê na maquininha.
+     */
+    serviceChargeByPosition?: Record<string, number>;
+    /** Sobrepõe o rótulo da pastilha compartilhada ("Mesa"/"Balcão"/"Pedido"). */
+    sharedLabel?: string;
+    /** Quanto já foi pago em cada comanda, por participante (chave `mesa` = o
+     *  compartilhado). O rail recebe o da comanda ativa. */
+    paidByPosition?: Record<string, Record<string, number>>;
+    /**
+     * Senta mais uma pessoa. A POSIÇÃO vem junto: o app não tem como saber
+     * sozinho em que mesa o operador está — quem sabe isso é esta tela.
+     */
+    /**
+     * O cliente da comanda foi identificado.
+     *
+     * O app decide o que fazer com isso — gravar o nome na comanda e, quando a
+     * primeira cadeira ainda não tem dono, dar o nome a ela também.
+     */
+    onIdentify?: (positionId: string, alias: string, phone?: string) => void | Promise<void>;
+    onAddGuest?: (draft: GuestDraft, positionId: string) => void | Promise<void>;
+    onIdentifyGuest?: (id: string, draft: GuestDraft) => void | Promise<void>;
+    onRemoveGuest?: (id: string) => void | Promise<void>;
+    onLookupPhone?: (phone: string) => Promise<{
+        id: string;
+        name: string;
+    } | null>;
     /** Fired when the operator opens a position, so the app can persist it. */
     onOpenPosition?: (positionId: string, guests: number, attendantId?: string) => void;
     /**
@@ -57,6 +344,24 @@ export interface PosScreenProps {
     verifyPin?: (pin: string, actionId: string) => PosStaff | null | Promise<PosStaff | null>;
     /** Called after a gated action is authorised, with who released it. */
     onAuthorised?: (actionId: string, by: PosStaff) => void;
+    /**
+     * Por que ESTA ação não pode agora — a regra de NEGÓCIO, que é do app.
+     *
+     * O pacote sabe que "não se cancela o que a cozinha não viu": isso é sobre a
+     * comanda e vale em qualquer casa. Mas "cortesia não existe em retirada nem
+     * em delivery, porque esses canais têm jornada própria de pagamento e
+     * repasse" é política do produto — e enfiá-la aqui faria o PDV carregar a
+     * regra fiscal de um país dentro de um componente de tela.
+     *
+     * O que o app devolve VENCE o padrão do pacote: uma casa pode proibir o que
+     * o pacote permitiria, e nunca o contrário.
+     */
+    actionGate?: (actionId: string, ctx: {
+        /** O menu aberto — é dele que sai o canal da venda. */
+        menuId?: string;
+        position?: PosPosition;
+        ticket: Ticket;
+    }) => string | undefined | false;
     /** Orders already open when the screen mounts, keyed by position id. */
     initialTickets?: Record<string, TicketLine[]>;
     /**
@@ -66,6 +371,22 @@ export interface PosScreenProps {
      * one that did not).
      */
     notice?: PosNotice;
+    /**
+     * O mapa do salão não carregou — a mesa «livre» pode não estar.
+     *
+     * Faixa FIXA enquanto durar, com a frase do V1. Ver `floorStale.ts`.
+     */
+    /**
+     * Há CAIXA ABERTO para quem está no teclado?
+     *
+     * O sexto motivo do V1 para a cortesia estar bloqueada — «Abra seu caixa para
+     * usar a cortesia». `undefined` quer dizer «não sei» e não bloqueia: o app que
+     * não lê sessão de caixa não deve negar por um caixa que ninguém conferiu.
+     */
+    cashOpen?: boolean;
+    floorStale?: boolean;
+    /** O «Tentar novamente» da faixa. Sem ele, o botão não aparece. */
+    onRetryFloor?: () => void;
     /**
      * The product's own mark, in the operator plate.
      *
@@ -113,6 +434,19 @@ export interface PosScreenProps {
      * — it never accepts a second one.
      */
     className?: string;
+    /**
+     * Sob que luz esta tela abre.
+     *
+     * `'dark'` (o padrão) é o terminal dedicado: ele vive sozinho num balcão, a
+     * noite inteira, e o carvão é o fundo certo. `'light'` é o PDV aberto POR
+     * CIMA de uma retaguarda clara — ali o operador estava numa tela de papel
+     * meio segundo antes, e trocar o fundo faria a chave de modo parecer troca
+     * de programa em vez de troca de lado da mesma casa.
+     *
+     * Não é um segundo design system: as duas peles declaram o MESMO conjunto
+     * de `--pos-*`, e toque, ritmo, raio e tempo não mudam entre elas.
+     */
+    theme?: 'dark' | 'light';
     /**
      * A MESMA costura do `className`, para o valor que não cabe numa classe.
      *
@@ -132,8 +466,21 @@ export interface PosScreenProps {
      * o operador ir cadastrar mesa que já existe.
      */
     loading?: boolean;
+    /**
+     * Quando esta cópia do cardápio saiu do banco (epoch ms).
+     *
+     * O cardápio do PDV não se relê a cada gesto — ver `catalog-cache` no
+     * plugin-menu. O preço disso é que o operador não sabe de quando é o que
+     * está vendo, e estes três campos são a resposta: a idade, a revalidação em
+     * curso e o gesto de forçar. Sem `onRefreshMenu` nada disso aparece.
+     */
+    menuFetchedAt?: number;
+    menuRefreshing?: boolean;
+    /** A última revalidação falhou; o que está na tela é a cópia anterior. */
+    menuStale?: boolean;
+    onRefreshMenu?: () => void;
     /** Injected in tests so elapsed times are not wall-clock dependent. */
     now?: number;
 }
-export declare function PosScreen({ config, categories, items, positions, staff, reservations, terminalName, operatorName, connection, operatorId, onAction, onOpenPosition, onFire, onCloseBill, onDispatch, verifyPin, onAuthorised, initialTickets, notice: appNotice, brandMark, brandName, className, style, railTop, unitSwitcher, loading, now, }: PosScreenProps): import("react").JSX.Element;
+export declare function PosScreen({ config, categories, items, positions, staff, reservations, terminalName, operatorName, waitlist, onWaitlistAdd, onWaitlistCall, onWaitlistSeat, onWaitlistNoShow, onWaitlistLookupPhone, onReservationArrived, connection, operatorId, onAction, onOpenPosition, onFire, onCloseBill, onDispatch, verifyPin, onAuthorised, actionGate, onDiscardTicket, initialTickets, notice: appNotice, cashOpen, floorStale, onRetryFloor, brandMark, brandName, className, theme, style, railTop, parties, sharedLabel, paidByPosition, serviceChargeByPosition, floorTool, shiftMode, onPickTarget, onCloseShift, registerEscape, onMoveTable: onMoveTableProp, onUpdateTable, onCreateZone, onUpdateZone, onTogglaMesaNaPraca, onDeleteZone, onArrange, onUpdateArea, floorScope, onConfigureTables, closedTickets, closedLoading, closedSeals, closedSealsFailed, onOpenClosed, onReopenClosed, railPanel, coversByPosition, onEditCover, paymentsByPosition, onEditGuestCount, onActivatePosition, onIdentify, onAddGuest, onIdentifyGuest, onRemoveGuest, onLookupPhone, unitSwitcher, loading, menuFetchedAt, menuRefreshing, menuStale, onRefreshMenu, now, }: PosScreenProps): import("react").JSX.Element;
 //# sourceMappingURL=PosScreen.d.ts.map

package/dist/screen/PosScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PosScreen.d.ts","sourceRoot":"","sources":["../../src/screen/PosScreen.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"PosScreen.d.ts","sourceRoot":"","sources":["../../src/screen/PosScreen.tsx"],"names":[],"mappings":"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"}

package/dist/screen/ServiceChargeSheet.d.ts

@@ -0,0 +1,98 @@
+/** Uma taxa cadastrada pela casa. */
+export interface ServicePreset {
+    id: string;
+    label: string;
+    percent: number;
+    isDefault?: boolean;
+}
+/** Um participante da comanda, para o percentual dele. */
+export interface ServiceGuest {
+    id: string;
+    label: string;
+    /** `null` = usa a taxa da mesa. Vazio NÃO é zero. */
+    percent?: number | null;
+    /** Quem já quitou não entra: a parte paga fica congelada. */
+    settled?: boolean;
+    /**
+     * A taxa que ESTE participante já pagou, em centavos — do `settledBill` que
+     * o banco gravou na hora do pagamento, não do que a tela somaria agora.
+     * Ver `SettledService` em `servicePreview`.
+     */
+    settledServiceCents?: number;
+}
+export interface ServiceChargeIntent {
+    percent: number;
+    /** Só os participantes cujo percentual MUDOU. */
+    guestOverrides: Array<{
+        guestId: string;
+        percent: number | null;
+    }>;
+}
+export declare function ServiceChargeSheet({ currentPercent, eligibleCents, lines, presets, guests, guestsUnavailable, authorizers, error, focusGuestId, onCancel, onConfirm, waivable, onWaive, }: {
+    currentPercent: number;
+    /** A base ELEGÍVEL, já sem as isenções — não o subtotal. */
+    eligibleCents: number;
+    /**
+     * As linhas ELEGÍVEIS, com o dono de cada uma.
+     *
+     * Sem elas a prévia inventava a sua própria conta de taxa — a TERCEIRA no
+     * PDV, depois da tela e do papel. Ver `previewServiceCents`.
+     */
+    lines?: Array<{
+        unitPriceCents: number;
+        quantity: number;
+        discountCents?: number;
+        guestId?: string | null;
+    }>;
+    presets: ServicePreset[];
+    /**
+     * A saída de emergência está aberta?
+     *
+     * Só depois de o servidor RECUSAR a mudança por pagamento sem dono, e só
+     * quando a intenção era BAIXAR a taxa — é o `offersWaive` do
+     * `serviceChargeGuard`. Não é item de menu: é o que resta quando o caminho
+     * normal fechou, e oferecê-la antes convidaria a usá-la como atalho para
+     * não cobrar.
+     */
+    waivable?: boolean;
+    /**
+     * A lista de participantes NÃO pôde ser lida.
+     *
+     * O V1 avisa e **trava o salvar** (`loadFailed` entra no `disabled` e no
+     * early return do confirm). A regra é sobre dinheiro: a taxa incide por
+     * participante, e sem saber quem já quitou a folha oferece como disponível
+     * quem fechou a conta — mexer no percentual dele mexe num total que alguém
+     * já pagou.
+     */
+    guestsUnavailable?: boolean;
+    /** Quem executa a retirada. Sem ele o aviso não aparece — um botão que não
+     *  tem para onde ir é pior do que a ausência dele. */
+    onWaive?: () => void;
+    guests: ServiceGuest[];
+    authorizers: Array<{
+        id: string;
+        name: string;
+    }>;
+    /**
+     * A recusa do SERVIDOR — PIN errado, alçada estourada, comanda travada.
+     *
+     * Vive na folha, e não num aviso atrás dela: a folha cobre a tela, e um
+     * recado que aparece por baixo não existe. Foi o que aconteceu ao portar a
+     * conferência de PIN — a autorização era recusada corretamente e o operador
+     * via a tela parada, sem uma palavra.
+     */
+    error?: string;
+    /**
+     * Abrir JÁ NAQUELA pessoa.
+     *
+     * O `13%` ao lado do nome de cada participante abre esta folha. Sem isto ela
+     * abria na taxa da mesa, com a lista de todo mundo embaixo — e numa mesa de
+     * vinte e duas pessoas o garçom precisava reencontrar, dentro da folha, a
+     * linha em que acabou de tocar. O alvo já disse de quem é: a folha começa
+     * ali.
+     */
+    focusGuestId?: string;
+    onCancel: () => void;
+    onConfirm: (intent: ServiceChargeIntent) => void;
+}): import("react").JSX.Element;
+//# sourceMappingURL=ServiceChargeSheet.d.ts.map