@12-apps/mcp 3.5.1 → 3.7.0

package/dist/react/index.d.ts

@@ -1,6 +1,162 @@
+import { ConfirmActionCopy } from '@12-apps/ui/copy';
 import { OnboardingStore, OnboardingStateSnapshot } from '@12-apps/onboarding';
-import { f as AiHostGuide, h as AiProvider, b as AiCapability, d as AiHostBrand } from '../guide-DV5MQbCg.js';
-export { A as AI_CAPABILITIES, a as AI_PERMISSION_MODEL, c as AiConnectPromptSpec, e as AiHostConfigureStage, g as AiHostLink, i as aiConnectPrompt, j as aiHostGuides, p as providerForHostId } from '../guide-DV5MQbCg.js';
+import { e as AiHostGuide, g as AiProvider, A as AiCapability, c as AiHostBrand } from '../guide-KQNcXlMG.js';
+export { b as AiConnectPromptSpec, d as AiHostConfigureStage, f as AiHostLink, h as aiConnectPrompt, p as providerForHostId } from '../guide-KQNcXlMG.js';
+export { P as PT_BR_AI_CAPABILITIES, a as PT_BR_AI_CONNECT_PROMPT, b as PT_BR_AI_HOST_GUIDES, c as PT_BR_AI_PERMISSION_MODEL } from '../pt-BR-e1RnV2v8.js';
+
+/**
+ * Every word the AI-integration screens render, as REQUIRED host config
+ * (FUT-760).
+ *
+ * These components used to take `capabilities` / `permissionModel` / `hosts` as
+ * OPTIONAL props defaulting to this package's own pt-BR, and to compile the rest
+ * of their sentences in outright. `guide.ts` even said so — "these are the
+ * shared defaults" — which is the anti-pattern named exactly: a host that
+ * configured nothing shipped one product's Portuguese, and nothing failed to
+ * say so.
+ *
+ * Split per screen rather than one flat map, because three of them
+ * (`AiLanding`, `AiCapabilities`, `AiStatusBoard`, `HostSelectStep`) are
+ * exported standalone and a host mounting only one should not have to supply
+ * words for screens it never renders.
+ */
+/** The marketing block's headline and its supporting line. */
+interface AiCapabilitiesCopy {
+    heading: string;
+    subheading: string;
+}
+/** One reassurance chip on the landing: an icon's label and its caption. */
+interface AiTrustPoint {
+    /** Stable id — maps to the icon in the component. */
+    id: string;
+    label: string;
+    caption: string;
+}
+interface AiLandingCopy {
+    /** Small line above the headline. */
+    eyebrow: string;
+    /** The headline's second half, after the assistant names. */
+    titleTail: string;
+    /** The paragraph under the headline. */
+    lede: string;
+    /** The reassurance strip. Order is the order rendered. */
+    trust: readonly AiTrustPoint[];
+    /** The call to action that starts the guided flow. */
+    start: string;
+}
+/** The wizard's step labels, in the order the stepper shows them. */
+interface AiFlowStepLabels {
+    select: string;
+    copyUrl: string;
+    configure: string;
+    connect: string;
+    install: string;
+    confirm: string;
+}
+/** The wizard's navigation words and each step's own sentences. */
+interface AiFlowCopy {
+    /** The stepper's labels. Not sentences, but still the host's words. */
+    steps: AiFlowStepLabels;
+    back: string;
+    next: string;
+    advance: string;
+    finish: string;
+    copyUrl: string;
+    copied: string;
+    copyMessage: string;
+    /** The copy-the-URL step's heading. Names the host's own noun for a tenant. */
+    copyUrlTitle: string;
+    /** Under the MCP URL: what this value is and what happens on copy. */
+    urlCaption: string;
+    /** Under the paste-in prompt: what the assistant will do with it. */
+    promptCaption: string;
+    /** The "ask the assistant to connect" step heading. */
+    askTitle: string;
+    /** The one-click install step's body, for a host with a published plugin. */
+    installBody: string;
+    /** The install button on that step. */
+    installAction: string;
+    /** Heading over the paste-in message on the manual path. */
+    pasteTitle: string;
+    /** Caption under the paste-in message on the install path. */
+    pasteInstallCaption: string;
+    /** Confirmation once a host reports in. */
+    connectedTo(hostLabel: string): string;
+    waitingTitle: string;
+    waitingBody(hostLabel: string): string;
+    testNow: string;
+}
+interface AiStatusBoardCopy {
+    instructions: string;
+    connected: string;
+    notConnected: string;
+    connect: string;
+    disconnect: string;
+    disconnectTitle: string;
+    disconnectBody: string;
+    disconnectConfirm: string;
+    /** Shown when the disconnect write fails without a reason of its own. */
+    disconnectError: string;
+    boardTitle: string;
+    boardCaption: string;
+    /**
+     * The confirmation popup's own furniture — its cancel button and fallbacks.
+     * `@12-apps/ui` stopped shipping defaults for these (FUT-760), so the words
+     * arrive here rather than from the design system's Portuguese.
+     */
+    confirmAction: ConfirmActionCopy;
+}
+/**
+ * The one-line summary of a connection's recency.
+ *
+ * Functions rather than strings because the number is interpolated and the
+ * plural rule is the host language's, not this package's.
+ */
+interface AiConnectionSummaryCopy {
+    /** Active within the last minute — no number to interpolate. */
+    activeNow: string;
+    activeMinutes(minutes: number): string;
+    activeHours(hours: number): string;
+    activeDays(days: number): string;
+    /** Connected, but too long ago to state a recency for. */
+    configured: string;
+    /** Appended after a host's name: `Claude Conectado`. */
+    connectedSuffix: string;
+    /** Several assistants at once, from an already-joined list of names. */
+    connectedSeveral(names: string): string;
+    /** Connected, but the provider was never attributed to a known assistant. */
+    connectedGeneric: string;
+}
+interface AiHostSelectCopy {
+    /** Why the owner is picking, under the host tiles. */
+    caption: string;
+}
+interface AiConnectGuideCopy {
+    /** The label on the MCP URL field. Names the host's own noun for a tenant. */
+    urlLabel: string;
+    /** Above the MCP URL field. */
+    urlHint: string;
+    /** Lead-in to the vendor's official connector docs link. */
+    moreInfo: string;
+    connectOn(hostLabel: string): string;
+}
+interface AiOnboardingCopy {
+    title: string;
+    /** The reveal toggle in the configured state, and its collapsed twin. */
+    editLabel: string;
+    collapseLabel: string;
+}
+/** Every screen's words, for a host mounting the whole flow. */
+interface McpAiCopy {
+    capabilities: AiCapabilitiesCopy;
+    landing: AiLandingCopy;
+    flow: AiFlowCopy;
+    statusBoard: AiStatusBoardCopy;
+    summary: AiConnectionSummaryCopy;
+    hostSelect: AiHostSelectCopy;
+    connectGuide: AiConnectGuideCopy;
+    onboarding: AiOnboardingCopy;
+}
 
 /**
  * Revoke a host's access. Returning a promise holds the confirmation popup in
@@ -23,16 +179,17 @@ interface HostStatus {
  * `announceAiConnection`), so several assistants can show connected at once.
  *
  * A connected box carries two more controls, because the pill it used to show
- * alone was a dead end in both directions: "Instruções" re-enters the host's
+ * alone was a dead end in both directions: "{copy.instructions}" re-enters the host's
  * setup steps (previously reachable only from a RED card, so an all-green board
  * hid them entirely), and "Desconectar" — when the app passes `onDisconnect` —
  * revokes access, which nothing in the UI could do at all.
  */
-declare function AiStatusBoard({ statuses, onConnect, onDisconnect, }: {
+declare function AiStatusBoard({ statuses, onConnect, onDisconnect, copy, }: {
     statuses: readonly HostStatus[];
     onConnect: (hostId: string) => void;
     /** Revoke this host's access. Omit to render a read-only board. */
     onDisconnect?: DisconnectHandler;
+    copy: AiStatusBoardCopy;
 }): React.JSX.Element;
 
 /**
@@ -68,20 +225,20 @@ interface AiIntegrationOnboardingProps {
     /** Show the dev-only "reset onboarding" button. @default false */
     devReset?: boolean;
     /**
-     * The platform operating this MCP server, as its OAuth consent button names
-     * it. REQUIRED, and it is the reason `hosts` can have a default at all: one
-     * ChatGPT step tells the owner which "Sign in with …" button to click, and
-     * that button carries whoever runs the server. It used to be a hard-coded
-     * name — of a single STORE on one deployment, not even the product — so every
-     * other adopter pointed its owners at a button that does not exist.
+     * Assistants offered in the flow, with their step-by-step instructions.
+     *
+     * REQUIRED since FUT-760. These used to default to this package's own pt-BR
+     * walkthrough, so a host that said nothing shipped one product's Portuguese
+     * and had no field to decline it. `PT_BR_AI_HOST_GUIDES(platformName)` is that
+     * exact content, now chosen by name.
      */
-    platformName: string;
-    /** Assistants offered in the flow. @default aiHostGuides(platformName) */
-    hosts?: readonly AiHostGuide[];
-    /** Capability cards on the landing. @default the shared AI_CAPABILITIES */
-    capabilities?: readonly AiCapability[];
-    /** Permission reassurance copy on the landing. @default AI_PERMISSION_MODEL */
-    permissionModel?: string;
+    hosts: readonly AiHostGuide[];
+    /** Capability cards on the landing. REQUIRED — see `hosts`. */
+    capabilities: readonly AiCapability[];
+    /** Permission reassurance copy on the landing. REQUIRED — see `hosts`. */
+    permissionModel: string;
+    /** Every sentence the screens render. REQUIRED — see `hosts`. */
+    copy: McpAiCopy;
     /**
      * Message the owner pastes into the assistant on the Conectar step.
      *
@@ -120,28 +277,33 @@ interface AiIntegrationOnboardingProps {
  * the live `connections` (one per connected assistant); content (hosts,
  * capabilities, copy) defaults to the shared guide but can be overridden per app.
  */
-declare function AiIntegrationOnboarding({ store, endpointUrl, initialState, connections, featureKey, devReset, platformName, hosts, capabilities, permissionModel, connectPrompt, onRetest, onDisconnect, }: AiIntegrationOnboardingProps): React.JSX.Element;
+declare function AiIntegrationOnboarding({ store, endpointUrl, initialState, connections, featureKey, devReset, hosts, capabilities, permissionModel, connectPrompt, onRetest, onDisconnect, copy, }: AiIntegrationOnboardingProps): React.JSX.Element;
 
 /**
  * Homepage-style marketing landing for the AI integration (shown before the
  * owner starts): a hero, the permission reassurance, a trust/feature strip, and
  * the capability highlights. `onStart` begins the guided flow. `permissionModel`
- * and `capabilities` default to the shared copy; apps can override.
+ * and `capabilities` are REQUIRED host copy — the package ships no default
+ * sentence (FUT-760).
  */
-declare function AiLanding({ onStart, permissionModel, capabilities, }: {
+declare function AiLanding({ onStart, permissionModel, capabilities, copy, capabilitiesCopy, }: {
     onStart: () => void;
-    permissionModel?: string;
-    capabilities?: readonly AiCapability[];
+    permissionModel: string;
+    capabilities: readonly AiCapability[];
+    copy: AiLandingCopy;
+    capabilitiesCopy: AiCapabilitiesCopy;
 }): React.JSX.Element;
 
 /**
  * Marketing block for the AI integration: a headline + a responsive grid of
  * capability cards. Shown on the onboarding landing (before the owner starts) to
  * sell the feature — "here's what the assistant does for you". `capabilities`
- * defaults to the shared set; apps can pass their own.
+ * and `copy` are REQUIRED host copy — the package ships no default sentence
+ * (FUT-760).
  */
-declare function AiCapabilities({ capabilities, }: {
-    capabilities?: readonly AiCapability[];
+declare function AiCapabilities({ capabilities, copy, }: {
+    capabilities: readonly AiCapability[];
+    copy: AiCapabilitiesCopy;
 }): React.JSX.Element;
 
 /**
@@ -151,10 +313,11 @@ declare function AiCapabilities({ capabilities, }: {
  * is controlled (persisted by the onboarding flow) so a refresh resumes with the
  * same assistant highlighted.
  */
-declare function HostSelectStep({ hosts, selectedId, onSelect, }: {
+declare function HostSelectStep({ hosts, selectedId, onSelect, copy, }: {
     hosts: readonly AiHostGuide[];
     selectedId: string | null;
     onSelect: (hostId: string) => void;
+    copy: AiHostSelectCopy;
 }): React.JSX.Element;
 
 /**
@@ -163,24 +326,28 @@ declare function HostSelectStep({ hosts, selectedId, onSelect, }: {
  * "Copiado" and `onCopy` fires after the clipboard write — the wizard uses it to
  * unlock the "Próximo" button on the Copiar-URL step.
  */
-declare function EndpointCopyBlock({ endpointUrl, copied, onCopy, }: {
+declare function EndpointCopyBlock({ endpointUrl, copied, onCopy, flowCopy, copy, }: {
     endpointUrl: string;
     copied: boolean;
     onCopy: () => void;
+    flowCopy: AiFlowCopy;
+    copy: AiConnectGuideCopy;
 }): React.JSX.Element;
 /**
  * A copyable multi-line message block (preserves line breaks). Used on the
  * Conectar step for the prompt the owner pastes into the assistant so it
  * identifies itself and calls a tool (which registers the connection).
  */
-declare function PromptCopyBlock({ title, caption, message, }: {
+declare function PromptCopyBlock({ title, caption, message, flowCopy, }: {
     title: string;
     caption: string;
     message: string;
+    flowCopy: AiFlowCopy;
 }): React.JSX.Element;
 /** The brand mark + "Conectar no <host>" header shared by the connect sub-steps. */
-declare function HostConnectHeader({ host }: {
+declare function HostConnectHeader({ host, copy, }: {
     host: AiHostGuide;
+    copy: AiConnectGuideCopy;
 }): React.JSX.Element;
 /**
  * The primary direct-link button to a host's connector settings (nothing when it
@@ -236,4 +403,15 @@ interface FeatureBadgeItem {
  */
 declare function FeatureBadge({ icon, label, caption }: FeatureBadgeItem): React.JSX.Element;
 
-export { AiCapabilities, AiCapability, type AiConnection, AiHostBrand, AiHostGuide, AiIntegrationOnboarding, type AiIntegrationOnboardingProps, AiLanding, AiProvider, AiStatusBoard, CapabilityIcon, type DisconnectHandler, EndpointCopyBlock, FeatureBadge, type FeatureBadgeItem, HostBrandAvatar, HostConnectHeader, HostOpenButton, HostSelectStep, type HostStatus, HostStepList, McpEndpointUrl, PromptCopyBlock };
+/**
+ * The pt-BR pack for the AI-integration screens — a NAMED constant a host
+ * passes by hand, never a default.
+ *
+ * The filename is what exempts this file from the copy-portability gate:
+ * Portuguese may ship, it may not be silent. Every sentence is VERBATIM what
+ * the components used to render, so a host adopting it sees no change on
+ * screen — what changes is that the words are chosen in a diff.
+ */
+declare const PT_BR_MCP_AI_COPY: McpAiCopy;
+
+export { AiCapabilities, type AiCapabilitiesCopy, AiCapability, type AiConnectGuideCopy, type AiConnection, type AiConnectionSummaryCopy, type AiFlowCopy, AiHostBrand, AiHostGuide, type AiHostSelectCopy, AiIntegrationOnboarding, type AiIntegrationOnboardingProps, AiLanding, type AiLandingCopy, type AiOnboardingCopy, AiProvider, AiStatusBoard, type AiStatusBoardCopy, type AiTrustPoint, CapabilityIcon, type DisconnectHandler, EndpointCopyBlock, FeatureBadge, type FeatureBadgeItem, HostBrandAvatar, HostConnectHeader, HostOpenButton, HostSelectStep, type HostStatus, HostStepList, type McpAiCopy, McpEndpointUrl, PT_BR_MCP_AI_COPY, PromptCopyBlock };