@studiolxd/brand 48.1.0 → 49.0.0

package/dist/_types/templates/ConnectorAuth/ConnectorConsentPage.d.ts

@@ -1,6 +1,28 @@
 import type { ReactNode } from 'react';
 import { type ConnectorAuthChromeProps } from './ConnectorAuthShell';
 import { ConnectorRequestSummary, type ConnectorScope } from './ConnectorRequestSummary';
+/**
+ * El cromo de la pantalla de consentimiento, y **solo el cromo**: cómo se
+ * titula y cómo se llama la salida que no concede nada.
+ *
+ * Todo lo demás de esta pantalla se queda fuera del catálogo y pasa a ser prop
+ * obligatoria, porque **afirma algo**: la frase que cuenta qué se pide
+ * (`intro`), el aviso de a dónde sale el acceso (`redirectNotice`), qué se
+ * concede (`scopeReadLabel`/`scopeWriteLabel`) y el rótulo del botón que
+ * concede (`approveLabel`). Es la misma línea que ya separa
+ * `confirmDialog.cancel` —cromo— de `ConfirmDialog.confirmLabel` —obligatoria,
+ * porque nombra la consecuencia—.
+ */
+export interface ConnectorConsentMessages {
+    /** Título de la pantalla. */
+    title: string;
+    /**
+     * Rótulo del botón que no concede nada. Es cromo por la misma razón que
+     * «Cancelar»: describe lo único que hace —no seguir— y no hay consecuencia
+     * que nombrar.
+     */
+    deny: string;
+}
 export interface ConnectorConsentPageProps extends ConnectorAuthChromeProps {
     /** El nombre con el que la herramienta se registró. **Dato de fuera**: ver `ConnectorRequestSummary`. */
     clientName: string;
@@ -55,15 +77,17 @@ export interface ConnectorConsentPageProps extends ConnectorAuthChromeProps {
      * abrir la página.
      */
     initialFocus?: 'none' | 'deny';
-    /** Título de la pantalla. Default castellano: «Conectar una herramienta». */
+    /** Título de la pantalla. **Sin default**: sin él, sale de `connectorConsent.title`. */
     title?: ReactNode;
     /**
      * La frase de la cabecera. Recibe las tres piezas ya compuestas —la
      * herramienta y la cuenta en negrita, el permiso en texto corriente— porque
      * el orden cambia con el idioma (en alemán la cuenta va antes del permiso).
-     * Default castellano.
+     *
+     * **Obligatoria y sin default**: es la frase que cuenta qué se está
+     * consintiendo, y el sistema de diseño no puede escribirla por el producto.
      */
-    intro?: (parts: {
+    intro: (parts: {
         client: ReactNode;
         what: ReactNode;
         email: ReactNode;
@@ -72,27 +96,37 @@ export interface ConnectorConsentPageProps extends ConnectorAuthChromeProps {
      * El aviso de a dónde se enviará el acceso, bajo la ficha. Recibe el host ya
      * en negrita. Va a tamaño de cuerpo, no de nota al pie: es la señal que
      * convierte una suplantación en visible y no puede leerse como letra
-     * pequeña. Default castellano.
+     * pequeña.
+     *
+     * **Obligatoria y sin default**: afirma a dónde sale el acceso y qué hacer
+     * si no se reconoce el destino. Un texto de catálogo la dejaría diciendo lo
+     * mismo en todas partes sin que nada fallara.
      */
-    redirectNotice?: (parts: {
+    redirectNotice: (parts: {
         host: ReactNode;
     }) => ReactNode;
-    /** Etiqueta del botón que concede. Default castellano: «Permitir acceso». */
-    approveLabel?: string;
-    /** Etiqueta del botón que deniega. Default castellano: «Denegar». */
+    /**
+     * Etiqueta del botón que concede.
+     *
+     * **Obligatoria y sin default, y fuera del catálogo**: es donde se toma la
+     * decisión, y tiene que nombrar la consecuencia. Mismo caso —y misma
+     * respuesta— que `ConfirmDialog.confirmLabel`.
+     */
+    approveLabel: string;
+    /** Etiqueta del botón que deniega. **Sin default**: sin ella, sale de `connectorConsent.deny`. */
     denyLabel?: string;
-    /** Alcance en texto, para la frase y para la ficha. Default castellano. */
-    scopeReadLabel?: string;
-    /** Ídem, lectura y escritura. Default castellano. */
-    scopeWriteLabel?: string;
-    /** Etiqueta del desplegador de un valor de fuera recortado. Default castellano: «Ver el valor completo». */
-    expandLabel?: string;
-    /** Etiqueta del desplegador abierto. Default castellano: «Ver menos». */
-    collapseLabel?: string;
     /**
-     * Las comillas que enmarcan los datos de fuera —la herramienta, la cuenta, el
-     * host—, aquí y en la ficha. Default castellano: `['«', '»']`.
+     * Qué se concede con `mcp:read`, para la frase y para la ficha.
+     * **Obligatoria y sin default**: ver `ConnectorRequestSummary`.
      */
+    scopeReadLabel: string;
+    /** Ídem, lectura y escritura. **Obligatoria y sin default**. */
+    scopeWriteLabel: string;
+    /** Reenvío puro a `UntrustedText` (`untrustedText.expand`). */
+    expandLabel?: string;
+    /** Reenvío puro a `UntrustedText` (`untrustedText.collapse`). */
+    collapseLabel?: string;
+    /** Reenvío puro a `UntrustedText` (`untrustedText.quotes`), aquí y en la ficha. */
     valueQuotes?: [string, string];
     /** Rótulos de la ficha. Ver `ConnectorRequestSummary`. */
     summaryLabels?: Pick<React.ComponentProps<typeof ConnectorRequestSummary>, 'clientLabel' | 'productLabel' | 'accountLabel' | 'scopeLabel' | 'redirectLabel'>;

package/dist/_types/templates/ConnectorAuth/ConnectorExternalSignInPage.d.ts

@@ -1,13 +1,38 @@
 import type { ReactNode } from 'react';
 import { type ConnectorAuthChromeProps } from './ConnectorAuthShell';
+/**
+ * El cromo de la pantalla del conector ajeno: el título, el rótulo del único
+ * campo y la plantilla del botón.
+ *
+ * `submit` es una **función** por la misma razón que
+ * `typingIndicator.typing(name)`: la frase tiene dos mitades que no se deciden
+ * en el mismo sitio. «Iniciar sesión con …» es cromo —el verbo y el orden son
+ * del idioma—, pero **cómo se llama la instalación** es contenido del
+ * producto y entra por `platformName`, que es obligatoria.
+ *
+ * Fuera del catálogo se quedan las dos frases que afirman algo: la que cuenta
+ * qué se está autorizando (`intro`) y la que confirma a dónde se entra
+ * (`signingInTo`).
+ */
+export interface ConnectorExternalSignInMessages {
+    /** Título de la pantalla. */
+    title: string;
+    /** Etiqueta del campo de organización. */
+    organization: string;
+    /** Plantilla del botón. Recibe el nombre de la instalación. */
+    submit: (platform: string) => string;
+}
 export interface ConnectorExternalSignInPageProps extends ConnectorAuthChromeProps {
     /**
      * Cómo se llama la instalación de la que es el conector, para la frase y
-     * para el botón. Default castellano: «tu Moodle», que hoy es el único
-     * conector de esta forma; cambiarlo sirve a cualquier otra instalación
-     * ajena a la suite.
+     * para el botón.
+     *
+     * **Obligatoria y sin default**: nombra al producto —hoy «tu Moodle», que es
+     * el único conector de esta forma—, y un nombre de producto no lo pone el
+     * sistema de diseño. Es una **cadena** porque el catálogo la interpola
+     * dentro del rótulo del botón (`connectorExternalSignIn.submit`).
      */
-    platformName?: ReactNode;
+    platformName: string;
     /**
      * La organización a la que se va a entrar, **ya resuelta**: el conector vive
      * en un subdominio y el servidor la saca del `resource` de la petición. Con
@@ -31,28 +56,43 @@ export interface ConnectorExternalSignInPageProps extends ConnectorAuthChromePro
     hiddenFields?: Record<string, string>;
     /** Un fallo del intento anterior —«no hay ninguna conexión para esa organización»—, sobre el formulario. */
     error?: ReactNode;
-    /** Título de la pantalla. Default castellano: «Autorizar la conexión». */
+    /** Título de la pantalla. **Sin default**: sin él, sale de `connectorExternalSignIn.title`. */
     title?: ReactNode;
-    /** La frase de la cabecera. Recibe el nombre de la instalación. Default castellano. */
-    intro?: (parts: {
+    /**
+     * La frase de la cabecera. Recibe el nombre de la instalación.
+     *
+     * **Obligatoria y sin default**: cuenta qué se está autorizando y con qué
+     * cuenta hay que identificarse. El sistema de diseño no puede afirmarlo por
+     * el producto.
+     */
+    intro: (parts: {
         platform: ReactNode;
     }) => ReactNode;
-    /** La frase que confirma a dónde se entra, con `organization`. Default castellano. */
-    signingInTo?: (parts: {
+    /**
+     * La frase que confirma a dónde se entra, con `organization`.
+     *
+     * **Obligatoria y sin default**, por lo mismo que `intro`: afirma a dónde va
+     * la sesión, que es el dato que convierte una suplantación en visible.
+     */
+    signingInTo: (parts: {
         organization: ReactNode;
     }) => ReactNode;
     /**
-     * Las comillas que enmarcan la organización en la frase de confirmación:
-     * viene de la petición, así que es dato de fuera y se pinta como tal. Default
-     * castellano: `['«', '»']`.
+     * Reenvío puro a `UntrustedText` (`untrustedText.quotes`): la organización
+     * viene de la petición, así que es dato de fuera y se pinta como tal.
      */
     valueQuotes?: [string, string];
-    /** Etiqueta del campo de organización. Default castellano: «Tu organización». */
+    /**
+     * Etiqueta del campo de organización. **Sin default**: sin ella, sale de
+     * `connectorExternalSignIn.organization`, y solo se lee cuando hay que
+     * escribir la organización.
+     */
     organizationLabel?: string;
-    /** Etiqueta de la acción. Recibe el nombre de la instalación. Default castellano. */
-    submitLabel?: (parts: {
-        platform: ReactNode;
-    }) => ReactNode;
+    /**
+     * Plantilla del rótulo de la acción, que recibe el nombre de la instalación.
+     * **Sin default**: sin ella, sale de `connectorExternalSignIn.submit`.
+     */
+    submitLabel?: (platform: string) => string;
     /**
      * Debajo del formulario: lo que no es del sistema de diseño. Es la ranura
      * donde el producto cuelga su andamio de desarrollo —pegar una clave de MCP,

package/dist/_types/templates/ConnectorAuth/ConnectorRejectionPage.d.ts

@@ -5,17 +5,42 @@ import { type ConnectorAuthChromeProps } from './ConnectorAuthShell';
  * autorización devuelve hoy en crudo —`invalid_client`,
  * `invalid_redirect_uri`, `access_denied`, `invalid_request`,
  * `login_required`—, uno por uno y con el nombre que entiende quien los lee.
+ *
+ * **Es un vocabulario, no una prop.** Desde la v49 los cuatro textos del
+ * rechazo los pasa el producto (`title`, `description`, `hint`, `retryLabel`),
+ * así que el tipo ya no elige nada dentro del componente: está aquí para que
+ * la aplicación teclee el motivo contra él al sacar del catálogo los cuatro
+ * textos, y para que la lista de motivos siga siendo una sola y esté escrita
+ * en el sistema.
  */
 export type ConnectorRejectionReason = 'invalid-client' | 'invalid-redirect-uri' | 'invalid-request' | 'access-denied' | 'session-expired';
+/**
+ * El único texto del rechazo que es cromo: el rótulo del código técnico.
+ *
+ * Los otros cuatro —qué pasó, qué se puede hacer y cómo se llama la salida—
+ * **afirman algo sobre una comprobación de seguridad** («no se ha enviado nada
+ * a ninguna parte», «si no la reconoces, no vuelvas a intentarlo») y son props
+ * obligatorias: el sistema de diseño no puede decidir qué se le cuenta a
+ * alguien sobre un acceso que no se ha concedido.
+ */
+export interface ConnectorRejectionMessages {
+    /** Rótulo del código técnico, bajo la explicación. */
+    code: string;
+}
 export interface ConnectorRejectionPageProps extends ConnectorAuthChromeProps {
-    /** Por qué no se ha conectado nada. De él salen el título, la explicación y el texto de la salida. */
-    reason: ConnectorRejectionReason;
-    /** Título, si el producto quiere el suyo. Default: el de la variante, en castellano. */
-    title?: ReactNode;
-    /** La frase bajo el título. Default: la de la variante, en castellano. */
-    description?: ReactNode;
-    /** Qué se puede hacer, en la columna de la derecha. Default: el de la variante, en castellano. */
-    hint?: ReactNode;
+    /**
+     * Qué ha pasado.
+     *
+     * **Obligatorio y sin default**: los cinco motivos afirman cada uno algo
+     * sobre una comprobación de seguridad —qué se ha enviado y qué no—, y eso lo
+     * escribe quien conoce el servidor de autorización, no un catálogo de cromo.
+     * El vocabulario de los cinco está en `ConnectorRejectionReason`.
+     */
+    title: ReactNode;
+    /** La frase bajo el título. **Obligatoria y sin default**, por lo mismo. */
+    description: ReactNode;
+    /** Qué se puede hacer, en la columna de la derecha. **Obligatoria y sin default**, por lo mismo. */
+    hint: ReactNode;
     /**
      * El código técnico tal cual lo devuelve el servidor (`invalid_client`…),
      * bajo la explicación. No es para quien lee la pantalla: es para que pueda
@@ -23,14 +48,25 @@ export interface ConnectorRejectionPageProps extends ConnectorAuthChromeProps {
      * palabras. Sin él, no se pinta.
      */
     code?: string;
-    /** Rótulo del código. Default castellano: «Código». */
+    /**
+     * Rótulo del código. **Sin default**: sin él, sale de
+     * `connectorRejection.code` del `BrandMessagesProvider`, y solo se lee
+     * cuando hay `code`.
+     */
     codeLabel?: string;
     /** La salida, como enlace: la vuelta a la herramienta o al acceso. */
     retryHref?: string;
     /** La salida, en modo React (sin `retryHref`). */
     onRetry?: () => void;
-    /** Etiqueta de la salida. Default: la de la variante, en castellano. */
-    retryLabel?: string;
+    /**
+     * Etiqueta de la salida.
+     *
+     * **Obligatoria y sin default**: nombra a dónde lleva —volver a la
+     * herramienta, volver a intentarlo, iniciar sesión—, y de los cinco motivos
+     * salen tres salidas distintas. Se pide aunque la salida se monte entera con
+     * `retryAction`: un rótulo que se traduce solo a veces acaba sin traducir.
+     */
+    retryLabel: string;
     /**
      * La salida entera, ya montada, cuando no basta con un botón (el `Link` del
      * router, dos acciones). Manda sobre `retryHref` / `onRetry`.
@@ -43,14 +79,22 @@ export interface ConnectorRejectionPageProps extends ConnectorAuthChromeProps {
  * **Una sola plantilla para los cinco rechazos**, que hoy son cinco respuestas
  * JSON en crudo sin ninguna pantalla detrás.
  *
- * Son cinco variantes y no cinco plantillas porque lo único que cambia entre
- * ellas es el texto. La maqueta es idéntica —la explicación a la izquierda, qué
+ * Son cinco motivos y una sola plantilla porque lo único que cambia entre
+ * ellos es el texto — y ese texto lo pasa el producto: `title`, `description`,
+ * `hint` y `retryLabel` son **obligatorias y sin default** desde la v49,
+ * porque cada una afirma algo sobre una comprobación de seguridad y eso no lo
+ * decide el sistema de diseño (ver `ConnectorRejectionMessages`). El
+ * vocabulario de los cinco sigue escrito aquí, en
+ * `ConnectorRejectionReason`, para que la aplicación teclee contra él al sacar
+ * los cuatro textos de su catálogo.
+ *
+ * La maqueta es idéntica en los cinco —la explicación a la izquierda, qué
  * hacer y la salida a la derecha—, y sobre todo lo es la postura: **ninguna
  * ofrece reintentar en el sitio**. Ni un botón que repita la petición ni un
  * formulario que la arregle; la conexión se empieza donde se empezó, en la
  * herramienta. Un rechazo de autorización que se pueda reintentar a golpes
  * desde la propia pantalla de rechazo es un fallo de seguridad, no una
- * comodidad, y por eso la salida por defecto es «volver» y no «reintentar».
+ * comodidad, y por eso la salida se llama «volver» y no «reintentar».
  *
  * Los cinco se agrupan en tres causas, y el texto de cada uno lo dice sin
  * jerga:
@@ -66,4 +110,4 @@ export interface ConnectorRejectionPageProps extends ConnectorAuthChromeProps {
  * hecho su trabajo —y en `access-denied`, ni siquiera eso: es lo que se ha
  * pedido—. La página lo cuenta como cuenta cualquier otra cosa.
  */
-export declare function ConnectorRejectionPage({ reason, title, description, hint, code, codeLabel, retryHref, onRetry, retryLabel, retryAction, aside, header, footer, preferences, preferencesLabel, id, shell, }: ConnectorRejectionPageProps): import("react/jsx-runtime").JSX.Element;
+export declare function ConnectorRejectionPage({ title, description, hint, code, codeLabel, retryHref, onRetry, retryLabel, retryAction, aside, header, footer, preferences, preferencesLabel, id, shell, }: ConnectorRejectionPageProps): import("react/jsx-runtime").JSX.Element;

package/dist/_types/templates/ConnectorAuth/ConnectorRequestSummary.d.ts

@@ -1,5 +1,28 @@
 import type { ReactNode } from 'react';
 import './ConnectorRequestSummary.css';
+/**
+ * Los cinco rótulos de la ficha. Son cromo: nombran **qué dato** va en cada
+ * fila —herramienta, producto, cuenta, permiso, destino—, que es el vocabulario
+ * cerrado de una petición de OAuth y dice lo mismo en los cinco productos de
+ * la suite.
+ *
+ * Lo que **no** está aquí es qué se concede (`scopeReadLabel`,
+ * `scopeWriteLabel`): eso afirma qué va a poder hacer la herramienta con los
+ * datos de quien lo lea, y el sistema de diseño no puede decidirlo. Son props
+ * obligatorias y sin default — ver `ConnectorRequestSummaryProps`.
+ */
+export interface ConnectorRequestSummaryMessages {
+    /** Rótulo de la herramienta. */
+    client: string;
+    /** Rótulo del producto. */
+    product: string;
+    /** Rótulo de la cuenta. */
+    account: string;
+    /** Rótulo del permiso. */
+    scope: string;
+    /** Rótulo del destino. */
+    redirect: string;
+}
 /** Qué se le concede al conector: leer, o leer y modificar. Son los dos únicos alcances que emite el servidor de autorización (`mcp:read` y `mcp:write`). */
 export type ConnectorScope = 'read' | 'write';
 export interface ConnectorRequestSummaryProps {
@@ -31,25 +54,33 @@ export interface ConnectorRequestSummaryProps {
      * lo impone el registro.
      */
     redirectHost?: ReactNode;
-    /** Rótulo de la herramienta. Default castellano: «Herramienta». */
+    /** Rótulo de la herramienta. **Sin default**: sin él, sale de `connectorRequestSummary.client`. */
     clientLabel?: string;
-    /** Rótulo del producto. Default castellano: «Producto». */
+    /** Rótulo del producto. **Sin default**: `connectorRequestSummary.product`, y solo con `productName`. */
     productLabel?: string;
-    /** Rótulo de la cuenta. Default castellano: «Cuenta». */
+    /** Rótulo de la cuenta. **Sin default**: `connectorRequestSummary.account`, y solo con `accountEmail`. */
     accountLabel?: string;
-    /** Rótulo del permiso. Default castellano: «Permiso». */
+    /** Rótulo del permiso. **Sin default**: `connectorRequestSummary.scope`, y solo con `scope`. */
     scopeLabel?: string;
-    /** Rótulo del destino. Default castellano: «Destino». */
+    /** Rótulo del destino. **Sin default**: `connectorRequestSummary.redirect`, y solo con `redirectHost`. */
     redirectLabel?: string;
-    /** Valor del permiso de solo lectura. Default castellano, el del servidor de autorización. */
-    scopeReadLabel?: ReactNode;
-    /** Valor del permiso de lectura y escritura. Default castellano, el del servidor de autorización. */
-    scopeWriteLabel?: ReactNode;
-    /** Etiqueta del desplegador de un valor recortado. Default castellano: «Ver el valor completo». */
+    /**
+     * Qué se concede con `mcp:read`, en texto.
+     *
+     * **Obligatoria y sin default, y fuera del catálogo**: es una afirmación
+     * sobre lo que la herramienta va a poder hacer con los datos de quien lee la
+     * pantalla, y eso lo sabe el servidor de autorización —que es quien emite el
+     * alcance— y no un catálogo de cromo. Un texto común aquí diría lo mismo en
+     * los cinco productos sin que nada fallara, que es exactamente el riesgo.
+     */
+    scopeReadLabel: ReactNode;
+    /** Ídem para `mcp:write`. **Obligatoria y sin default**, por lo mismo. */
+    scopeWriteLabel: ReactNode;
+    /** Reenvío puro a `UntrustedText`, que lee `untrustedText.expand` por su cuenta. */
     expandLabel?: string;
-    /** Etiqueta del desplegador abierto. Default castellano: «Ver menos». */
+    /** Reenvío puro a `UntrustedText` (`untrustedText.collapse`). */
     collapseLabel?: string;
-    /** Las comillas que enmarcan los valores de fuera. Default castellano: `['«', '»']`. */
+    /** Reenvío puro a `UntrustedText` (`untrustedText.quotes`). */
     valueQuotes?: [string, string];
     /** Se añade DESPUÉS de las clases propias. */
     className?: string;

package/dist/_types/templates/ConnectorAuth/ConnectorSignInPage.d.ts

@@ -1,6 +1,27 @@
 import type { ReactNode } from 'react';
 import { type ConnectorAuthChromeProps } from './ConnectorAuthShell';
 import { ConnectorRequestSummary, type ConnectorScope } from './ConnectorRequestSummary';
+/**
+ * El cromo de la pantalla de identificarse dentro del flujo del conector.
+ *
+ * Aquí **no se concede nada** —la única acción es iniciar sesión—, así que el
+ * título y el rótulo de la acción sí son cromo: describen lo que hace el
+ * control, no una consecuencia sobre los datos de nadie. La frase que cuenta
+ * qué pide la herramienta (`intro`) y qué se pedirá (`scopeReadLabel` /
+ * `scopeWriteLabel`) siguen fuera, obligatorias.
+ */
+export interface ConnectorSignInMessages {
+    /** Título de la pantalla. */
+    title: string;
+    /** Rótulo de la acción de identificarse. */
+    signIn: string;
+    /**
+     * Cómo se nombra el producto en la frase cuando la pantalla no recibe
+     * `productName` («este producto»). Es un relleno genérico, no el nombre de
+     * nada: el nombre de verdad viaja en `productName`.
+     */
+    fallbackProduct: string;
+}
 export interface ConnectorSignInPageProps extends ConnectorAuthChromeProps {
     /** El nombre con el que la herramienta se registró. **Dato de fuera**: ver `ConnectorRequestSummary`. */
     clientName: string;
@@ -22,29 +43,42 @@ export interface ConnectorSignInPageProps extends ConnectorAuthChromeProps {
     action?: string;
     /** Los parámetros de OAuth que tienen que sobrevivir al acceso, como `<input type="hidden">`. */
     hiddenFields?: Record<string, string>;
-    /** Título de la pantalla. Default castellano. */
+    /** Título de la pantalla. **Sin default**: sin él, sale de `connectorSignIn.title`. */
     title?: ReactNode;
     /**
      * La frase de la cabecera. Recibe la herramienta y el producto ya
-     * compuestos. Default castellano.
+     * compuestos.
+     *
+     * **Obligatoria y sin default**: cuenta qué herramienta hay detrás y para
+     * qué se está tecleando una contraseña. Eso no lo escribe un catálogo de
+     * cromo.
      */
-    intro?: (parts: {
+    intro: (parts: {
         client: ReactNode;
         product: ReactNode;
     }) => ReactNode;
-    /** Nombre del producto cuando no se pasa `productName`, para la frase. Default castellano: «este producto». */
+    /**
+     * Cómo se nombra el producto en la frase cuando no se pasa `productName`.
+     * **Sin default**: sin ella, sale de `connectorSignIn.fallbackProduct`, y
+     * solo se lee cuando falta `productName`.
+     */
     fallbackProductName?: ReactNode;
-    /** Etiqueta de la acción. Default castellano: «Iniciar sesión». */
+    /** Etiqueta de la acción. **Sin default**: sin ella, sale de `connectorSignIn.signIn`. */
     signInLabel?: string;
-    /** Alcance en texto. Default castellano. */
-    scopeReadLabel?: string;
-    /** Ídem, lectura y escritura. Default castellano. */
-    scopeWriteLabel?: string;
-    /** Etiqueta del desplegador de un valor de fuera recortado. Default castellano: «Ver el valor completo». */
+    /**
+     * Qué se pedirá con `mcp:read`. **Obligatoria y sin default**: ver
+     * `ConnectorRequestSummary`. Solo se pinta si hay `scope`, pero se pide
+     * siempre — un alcance que se muestra a veces no puede depender de que
+     * alguien se acordara de traducirlo.
+     */
+    scopeReadLabel: string;
+    /** Ídem, lectura y escritura. **Obligatoria y sin default**. */
+    scopeWriteLabel: string;
+    /** Reenvío puro a `UntrustedText` (`untrustedText.expand`). */
     expandLabel?: string;
-    /** Etiqueta del desplegador abierto. Default castellano: «Ver menos». */
+    /** Reenvío puro a `UntrustedText` (`untrustedText.collapse`). */
     collapseLabel?: string;
-    /** Las comillas que enmarcan los datos de fuera. Default castellano: `['«', '»']`. */
+    /** Reenvío puro a `UntrustedText` (`untrustedText.quotes`). */
     valueQuotes?: [string, string];
     /** Rótulos de la ficha. Ver `ConnectorRequestSummary`. */
     summaryLabels?: Pick<React.ComponentProps<typeof ConnectorRequestSummary>, 'clientLabel' | 'productLabel' | 'scopeLabel' | 'redirectLabel'>;

package/dist/_types/templates/ConnectorAuth/UntrustedText.d.ts

@@ -1,5 +1,24 @@
 import type { ReactNode } from 'react';
 import './UntrustedText.css';
+/**
+ * El cromo con el que se enmarca un dato de fuera: el desplegador de un valor
+ * recortado y las comillas que dicen dónde empieza y dónde acaba el texto
+ * ajeno.
+ *
+ * **Los tres son cromo y ninguno afirma nada**, así que van al catálogo: «Ver
+ * el valor completo» describe lo único que hace ese desplegador, y las
+ * comillas son puntuación del idioma (`['„', '“']` en alemán), no una decisión
+ * del producto. Lo que sí es de fuera —el valor— entra por `value` y nunca
+ * pasa por aquí.
+ */
+export interface UntrustedTextMessages {
+    /** Etiqueta del desplegador cerrado. */
+    expand: string;
+    /** Etiqueta del desplegador abierto. */
+    collapse: string;
+    /** Las comillas que enmarcan el valor, apertura y cierre. */
+    quotes: [string, string];
+}
 export interface UntrustedTextProps {
     /**
      * El valor. Si es una cadena recibe el tratamiento entero —marcado de
@@ -16,13 +35,21 @@ export interface UntrustedTextProps {
      * quiera verlo entero lo despliega en la ficha.
      */
     expandable?: boolean;
-    /** Etiqueta del desplegador cerrado. Default castellano: «Ver el valor completo». */
+    /**
+     * Etiqueta del desplegador cerrado. **Sin default**: sin ella, sale de
+     * `untrustedText.expand` del `BrandMessagesProvider`, y solo se lee cuando
+     * el valor se recorta con `expandable`.
+     */
     expandLabel?: string;
-    /** Etiqueta del desplegador abierto. Default castellano: «Ver menos». */
+    /**
+     * Etiqueta del desplegador abierto. **Sin default**: sin ella, sale de
+     * `untrustedText.collapse`, en el mismo caso.
+     */
     collapseLabel?: string;
     /**
-     * Las comillas que enmarcan el valor. Default castellano: `['«', '»']`. Van
-     * en prop porque cambian con el idioma (`['„', '“']` en alemán).
+     * Las comillas que enmarcan el valor. **Sin default**: sin ellas, salen de
+     * `untrustedText.quotes`. Cambian con el idioma (`['„', '“']` en alemán), y
+     * por eso están en el catálogo y no cableadas.
      */
     quotes?: [string, string];
     /** Se añade DESPUÉS de las clases propias. */