@adatechnology/scheduling-ui 0.1.0-rc.1

package/dist/index.d.ts

@@ -0,0 +1,316 @@
+import * as _adatechnology_scheduling_contracts from '@adatechnology/scheduling-contracts';
+import { ListResourcesParams, PaginatedResponse, Resource, CreateResourceInput, ResourceId, UpdateResourceInput, ListServicesParams, Service, CreateServiceInput, ServiceId, UpdateServiceInput, AvailabilityRule, CreateAvailabilityRuleInput, AvailabilityException, CreateAvailabilityExceptionInput, AvailabilityExceptionId, GetAvailabilityParams, AvailableSlot, ListBookingsParams, Booking, BookingId, RequestBookingInput, RescheduleBookingInput, CancelBookingInput, ResourceKind } from '@adatechnology/scheduling-contracts';
+import * as react from 'react';
+import { ReactNode } from 'react';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { UseMutationResult } from '@tanstack/react-query';
+
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ *
+ * `SchedulingApi` é a fronteira com o host: cada método espelha um caso de uso de
+ * `scheduling-module`, sem `companyId` — o host já resolve o tenant do contexto autenticado antes
+ * de chamar o pacote (`security.md` §2, BOLA). O pacote nunca decide como a requisição é feita.
+ */
+
+type SchedulingApi = {
+    listResources(params?: Omit<ListResourcesParams, 'companyId'>): Promise<PaginatedResponse<Resource>>;
+    createResource(input: CreateResourceInput): Promise<Resource>;
+    updateResource(id: ResourceId, input: UpdateResourceInput): Promise<Resource>;
+    deleteResource(id: ResourceId): Promise<void>;
+    listServices(params?: Omit<ListServicesParams, 'companyId'>): Promise<PaginatedResponse<Service>>;
+    createService(input: CreateServiceInput): Promise<Service>;
+    updateService(id: ServiceId, input: UpdateServiceInput): Promise<Service>;
+    deleteService(id: ServiceId): Promise<void>;
+    listAvailabilityRules(resourceId: ResourceId): Promise<readonly AvailabilityRule[]>;
+    setAvailabilityRules(resourceId: ResourceId, rules: readonly CreateAvailabilityRuleInput[]): Promise<readonly AvailabilityRule[]>;
+    listAvailabilityExceptions(resourceId: ResourceId): Promise<readonly AvailabilityException[]>;
+    addAvailabilityException(input: CreateAvailabilityExceptionInput): Promise<AvailabilityException>;
+    removeAvailabilityException(id: AvailabilityExceptionId): Promise<void>;
+    getAvailableSlots(params: Omit<GetAvailabilityParams, 'companyId'>): Promise<readonly AvailableSlot[]>;
+    listBookings(params?: Omit<ListBookingsParams, 'companyId'>): Promise<PaginatedResponse<Booking>>;
+    getBooking(id: BookingId): Promise<Booking>;
+    requestBooking(input: RequestBookingInput, idempotencyKey: string): Promise<Booking>;
+    confirmBooking(id: BookingId): Promise<Booking>;
+    rescheduleBooking(id: BookingId, input: RescheduleBookingInput): Promise<Booking>;
+    cancelBooking(id: BookingId, input: CancelBookingInput): Promise<Booking>;
+    completeBooking(id: BookingId): Promise<Booking>;
+    markNoShow(id: BookingId): Promise<Booking>;
+};
+type SchedulingUiConfig = {
+    readonly locale: string;
+    /** 0 = domingo, 1 = segunda — só a grade de agenda (T7.3) e o editor de disponibilidade (T7.4) usam. */
+    readonly weekStartsOn: 0 | 1;
+    /**
+     * F-016: expediente exibido na grade de agenda (T7.3) — hora local, `[agendaStartHour,
+     * agendaEndHour)`. Cada host define o próprio; o pacote não presume horário comercial de
+     * nenhum produto.
+     */
+    readonly agendaStartHour: number;
+    readonly agendaEndHour: number;
+};
+declare const DEFAULT_SCHEDULING_UI_CONFIG: SchedulingUiConfig;
+
+type SchedulingProviderProps = {
+    readonly api: SchedulingApi;
+    readonly config?: Partial<SchedulingUiConfig>;
+    readonly children: ReactNode;
+};
+declare function SchedulingProvider({ api, config, children }: SchedulingProviderProps): react.JSX.Element;
+declare function useScheduling(): SchedulingApi;
+declare function useSchedulingConfig(): SchedulingUiConfig;
+
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ *
+ * Chaves centralizadas: mutação e listagem da mesma entidade precisam invalidar a mesma raiz, e
+ * uma chave montada inline em cada hook é como agenda e tabela de reservas passam a mostrar
+ * estados diferentes depois de uma confirmação.
+ */
+declare const SCHEDULING_QUERY_KEYS: {
+    readonly resources: {
+        readonly all: readonly ["scheduling", "resources"];
+        readonly list: (params: unknown) => readonly ["scheduling", "resources", "list", unknown];
+    };
+    readonly services: {
+        readonly all: readonly ["scheduling", "services"];
+        readonly list: (params: unknown) => readonly ["scheduling", "services", "list", unknown];
+    };
+    readonly availabilityRules: {
+        readonly all: (resourceId: string) => readonly ["scheduling", "availability-rules", string];
+    };
+    readonly availabilityExceptions: {
+        readonly all: (resourceId: string) => readonly ["scheduling", "availability-exceptions", string];
+    };
+    readonly availableSlots: {
+        readonly list: (params: unknown) => readonly ["scheduling", "available-slots", unknown];
+    };
+    readonly bookings: {
+        readonly all: readonly ["scheduling", "bookings"];
+        readonly list: (params: unknown) => readonly ["scheduling", "bookings", "list", unknown];
+        readonly detail: (id: string) => readonly ["scheduling", "bookings", "detail", string];
+    };
+};
+
+type UseResourcesOptions = {
+    readonly page?: number;
+    readonly pageSize?: number;
+    readonly kind?: ResourceKind;
+    readonly active?: boolean;
+};
+declare function useResources(options?: UseResourcesOptions): _tanstack_react_query.UseQueryResult<NoInfer<_adatechnology_scheduling_contracts.PaginatedResponse<_adatechnology_scheduling_contracts.Resource>>, Error>;
+
+declare function useCreateResource(): _tanstack_react_query.UseMutationResult<_adatechnology_scheduling_contracts.Resource, Error, CreateResourceInput, unknown>;
+declare function useUpdateResource(): _tanstack_react_query.UseMutationResult<_adatechnology_scheduling_contracts.Resource, Error, {
+    readonly id: ResourceId;
+    readonly input: UpdateResourceInput;
+}, unknown>;
+declare function useDeleteResource(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
+
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ */
+type UseServicesOptions = {
+    readonly page?: number;
+    readonly pageSize?: number;
+    readonly active?: boolean;
+};
+declare function useServices(options?: UseServicesOptions): _tanstack_react_query.UseQueryResult<NoInfer<_adatechnology_scheduling_contracts.PaginatedResponse<_adatechnology_scheduling_contracts.Service>>, Error>;
+
+declare function useCreateService(): _tanstack_react_query.UseMutationResult<_adatechnology_scheduling_contracts.Service, Error, CreateServiceInput, unknown>;
+declare function useUpdateService(): _tanstack_react_query.UseMutationResult<_adatechnology_scheduling_contracts.Service, Error, {
+    readonly id: ServiceId;
+    readonly input: UpdateServiceInput;
+}, unknown>;
+declare function useDeleteService(): _tanstack_react_query.UseMutationResult<void, Error, string, unknown>;
+
+declare function useAvailabilityRules(resourceId: ResourceId): _tanstack_react_query.UseQueryResult<NoInfer<readonly _adatechnology_scheduling_contracts.AvailabilityRule[]>, Error>;
+
+declare function useAvailabilityExceptions(resourceId: ResourceId): _tanstack_react_query.UseQueryResult<NoInfer<readonly _adatechnology_scheduling_contracts.AvailabilityException[]>, Error>;
+
+declare function useSetAvailabilityRules(): _tanstack_react_query.UseMutationResult<readonly _adatechnology_scheduling_contracts.AvailabilityRule[], Error, {
+    readonly resourceId: ResourceId;
+    readonly rules: readonly CreateAvailabilityRuleInput[];
+}, unknown>;
+declare function useAddAvailabilityException(): _tanstack_react_query.UseMutationResult<_adatechnology_scheduling_contracts.AvailabilityException, Error, CreateAvailabilityExceptionInput, unknown>;
+declare function useRemoveAvailabilityException(): _tanstack_react_query.UseMutationResult<void, Error, {
+    readonly id: AvailabilityExceptionId;
+    readonly resourceId: ResourceId;
+}, unknown>;
+
+type UseAvailableSlotsParams = Omit<GetAvailabilityParams, 'companyId'>;
+declare function useAvailableSlots(params: UseAvailableSlotsParams): _tanstack_react_query.UseQueryResult<NoInfer<readonly _adatechnology_scheduling_contracts.AvailableSlot[]>, Error>;
+
+type UseBookingsParams = Omit<ListBookingsParams, 'companyId'>;
+declare function useBookings(params?: UseBookingsParams): _tanstack_react_query.UseQueryResult<NoInfer<_adatechnology_scheduling_contracts.PaginatedResponse<_adatechnology_scheduling_contracts.Booking>>, Error>;
+declare function useBooking(id: BookingId): _tanstack_react_query.UseQueryResult<NoInfer<_adatechnology_scheduling_contracts.Booking>, Error>;
+
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ */
+
+declare function useConfirmBooking(): UseMutationResult<Booking, Error, BookingId>;
+declare function useCancelBooking(): UseMutationResult<Booking, Error, {
+    readonly id: BookingId;
+    readonly input: CancelBookingInput;
+}, unknown>;
+declare function useCompleteBooking(): UseMutationResult<Booking, Error, BookingId>;
+declare function useMarkNoShow(): UseMutationResult<Booking, Error, BookingId>;
+
+declare function useRequestBooking(): _tanstack_react_query.UseMutationResult<_adatechnology_scheduling_contracts.Booking, Error, {
+    readonly input: RequestBookingInput;
+    readonly idempotencyKey: string;
+}, unknown>;
+
+declare function useRescheduleBooking(): _tanstack_react_query.UseMutationResult<_adatechnology_scheduling_contracts.Booking, Error, {
+    readonly id: BookingId;
+    readonly input: RescheduleBookingInput;
+}, unknown>;
+
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ *
+ * Vocabulário da moldura do workspace — título e nome das abas. Tudo sobrescrevível via prop
+ * `labels`, sem manter cópia da tela (T7.2). Texto interno de cada área vem de `src/locales`.
+ */
+interface SchedulingWorkspaceLabels {
+    readonly title: string;
+    readonly areaNav: string;
+    readonly agendaTab: string;
+    readonly bookingsTab: string;
+    readonly resourcesTab: string;
+    readonly servicesTab: string;
+    readonly availabilityTab: string;
+}
+declare const DEFAULT_SCHEDULING_WORKSPACE_LABELS: SchedulingWorkspaceLabels;
+
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ *
+ * Cinco áreas, e não uma lista só: agenda, reservas, recursos, serviços e disponibilidade têm
+ * colunas, filtros e frequência de uso diferentes (spec §T7.2) — empilhar tudo numa tela esconderia
+ * a maioria atrás de scroll.
+ */
+declare const SCHEDULING_WORKSPACE_AREA: {
+    readonly AGENDA: "agenda";
+    readonly BOOKINGS: "bookings";
+    readonly RESOURCES: "resources";
+    readonly SERVICES: "services";
+    readonly AVAILABILITY: "availability";
+};
+type SchedulingWorkspaceArea = (typeof SCHEDULING_WORKSPACE_AREA)[keyof typeof SCHEDULING_WORKSPACE_AREA];
+declare function isSchedulingWorkspaceArea(value: string): value is SchedulingWorkspaceArea;
+
+type SchedulingWorkspaceProps = {
+    readonly labels?: Partial<SchedulingWorkspaceLabels>;
+    /** Ações do produto no cabeçalho (ex: exportar agenda). Ausente, nada é desenhado. */
+    readonly renderHeaderActions?: () => ReactNode;
+    /**
+     * Área aberta, controlada pelo host — é assim que ela vai para a query string e sobrevive ao
+     * refresh e ao link colado. Sem `onAreaChange` a tela controla a própria área internamente.
+     */
+    readonly area?: SchedulingWorkspaceArea;
+    readonly onAreaChange?: (area: SchedulingWorkspaceArea) => void;
+};
+declare function SchedulingWorkspace({ labels: labelsOverride, renderHeaderActions, area: areaProp, onAreaChange, }: SchedulingWorkspaceProps): react.JSX.Element;
+
+var ptBR = {
+	"common.close": "Fechar",
+	"common.cancel": "Cancelar",
+	"common.save": "Salvar",
+	"common.remove": "Excluir",
+	"common.loading": "Carregando…",
+	"common.loadFailure": "Não foi possível carregar",
+	"common.actionFailure": "Ação falhou. Tente novamente.",
+	"common.empty": "Nada por aqui ainda",
+	"common.clearFilters": "Limpar filtros",
+	"common.selectAll": "Selecionar todos",
+	"common.previousPage": "Página anterior",
+	"common.nextPage": "Próxima página",
+	"resource.newResource": "Novo recurso",
+	"resource.editTitle": "Editar recurso",
+	"resource.createTitle": "Novo recurso",
+	"resource.name": "Nome",
+	"resource.kind": "Tipo",
+	"resource.timezone": "Fuso horário",
+	"resource.active": "Ativo",
+	"resource.inactive": "Inativo",
+	"resource.kind.person": "Pessoa",
+	"resource.kind.room": "Sala",
+	"resource.kind.equipment": "Equipamento",
+	"service.newService": "Novo serviço",
+	"service.editTitle": "Editar serviço",
+	"service.createTitle": "Novo serviço",
+	"service.name": "Nome",
+	"service.durationMinutes": "Duração (minutos)",
+	"service.bufferBeforeMinutes": "Intervalo antes (minutos)",
+	"service.bufferAfterMinutes": "Intervalo depois (minutos)",
+	"service.active": "Ativo",
+	"service.inactive": "Inativo",
+	"agenda.resourceLabel": "Recurso",
+	"agenda.today": "Hoje",
+	"agenda.previous": "Anterior",
+	"agenda.next": "Próximo",
+	"agenda.viewDay": "Dia",
+	"agenda.viewWeek": "Semana",
+	"agenda.empty": "Sem reservas neste período",
+	"availability.weeklyRulesTitle": "Regras semanais",
+	"availability.exceptionsTitle": "Exceções",
+	"availability.resourceTimezone": "Fuso do recurso",
+	"availability.addRule": "Adicionar regra",
+	"availability.removeRule": "Remover",
+	"availability.addException": "Adicionar exceção",
+	"availability.removeException": "Remover",
+	"availability.exceptionKind.blocked": "Bloqueio",
+	"availability.exceptionKind.extra": "Extra",
+	"availability.exceptionReason": "Motivo",
+	"availability.weekday.0": "Domingo",
+	"availability.weekday.1": "Segunda",
+	"availability.weekday.2": "Terça",
+	"availability.weekday.3": "Quarta",
+	"availability.weekday.4": "Quinta",
+	"availability.weekday.5": "Sexta",
+	"availability.weekday.6": "Sábado",
+	"booking.status.requested": "Solicitada",
+	"booking.status.confirmed": "Confirmada",
+	"booking.status.cancelled": "Cancelada",
+	"booking.status.completed": "Concluída",
+	"booking.status.noShow": "Não compareceu",
+	"booking.confirm": "Confirmar",
+	"booking.cancel": "Cancelar reserva",
+	"booking.complete": "Concluir",
+	"booking.markNoShow": "Marcar não compareceu",
+	"booking.reschedule": "Reagendar",
+	"booking.detailTitle": "Detalhes da reserva",
+	"booking.cancelReason": "Motivo do cancelamento",
+	"booking.cancelledBy": "Cancelado por",
+	"booking.column.title": "Título",
+	"booking.column.resource": "Recurso",
+	"booking.column.status": "Status",
+	"booking.column.startsAt": "Início",
+	"booking.column.endsAt": "Fim",
+	"booking.column.actions": "Ações",
+	"booking.filterByStatus": "Filtrar por status",
+	"booking.bulkConfirm": "Confirmar selecionadas",
+	"booking.bulkCancel": "Cancelar selecionadas",
+	"availability.weekdayLabel": "Dia da semana",
+	"availability.startsAtLocal": "Início",
+	"availability.endsAtLocal": "Fim",
+	"availability.exceptionFrom": "De",
+	"availability.exceptionUntil": "Até"
+};
+
+/**
+ * Copyright (c) 2026 Ada Technology. MIT License.
+ *
+ * Textos internos dos componentes (rótulos de campo, dias da semana, status). Vocabulário da moldura
+ * do workspace (título, abas) é responsabilidade de `workspace/labels.ts` — separado porque o host
+ * troca o nome de uma aba com muito mais frequência do que troca "Domingo" por outra palavra.
+ */
+
+type SchedulingMessages = typeof ptBR;
+type SchedulingLocale = 'pt-BR' | 'en';
+declare const DEFAULT_SCHEDULING_LOCALE: SchedulingLocale;
+declare function resolveSchedulingMessages(locale: string): SchedulingMessages;
+
+export { DEFAULT_SCHEDULING_LOCALE, DEFAULT_SCHEDULING_UI_CONFIG, DEFAULT_SCHEDULING_WORKSPACE_LABELS, SCHEDULING_QUERY_KEYS, SCHEDULING_WORKSPACE_AREA, type SchedulingApi, type SchedulingLocale, type SchedulingMessages, SchedulingProvider, type SchedulingProviderProps, type SchedulingUiConfig, SchedulingWorkspace, type SchedulingWorkspaceArea, type SchedulingWorkspaceLabels, type SchedulingWorkspaceProps, type UseAvailableSlotsParams, type UseBookingsParams, type UseResourcesOptions, type UseServicesOptions, isSchedulingWorkspaceArea, resolveSchedulingMessages, useAddAvailabilityException, useAvailabilityExceptions, useAvailabilityRules, useAvailableSlots, useBooking, useBookings, useCancelBooking, useCompleteBooking, useConfirmBooking, useCreateResource, useCreateService, useDeleteResource, useDeleteService, useMarkNoShow, useRemoveAvailabilityException, useRequestBooking, useRescheduleBooking, useResources, useScheduling, useSchedulingConfig, useServices, useSetAvailabilityRules, useUpdateResource, useUpdateService };