@studiolxd/brand 49.23.0 → 49.23.1

package/CHANGELOG.md

@@ -7,6 +7,26 @@ El paquete sigue [semver](https://semver.org/lang/es/): **patch** para bug fixes
 regeneración de `dist`, **minor** para componentes/props/variantes/tokens nuevos, **major**
 para breaking changes.
 
+## [49.23.1] — 2026-10-04
+
+> **Patch.** `appHeader` pasa a ser **opcional** en `BrandMessages`. En 49.23.0 entró obligatorio y un
+> catálogo tipado estricto —un literal pasado a `BrandMessagesProvider` sin conversión, como el de
+> `public-shell` en slxd— dejaba de compilar aunque no usara el logo: una minor no puede romper la
+> compilación de nadie. Si ya declaraste `appHeader`, no hay que tocar nada.
+
+- `BrandMessages.appHeader?` y `AppHeaderMessages.logo?`: solo hacen falta si algún `AppHeader` lleva
+  `logo` sin `logoLabel`.
+- **Si ese caso llega sin `appHeader.logo` en el catálogo, `AppHeader` lanza** («el catálogo montado no
+  trae «appHeader.logo»»), igual que cualquier otra clave ausente: no hay castellano de respaldo y un
+  enlace sin nombre accesible tiene que verse en desarrollo. Documentado en `AppHeader` §
+  «Internacionalización».
+- `BrandMessagesReader` lee los espacios opcionales sin `undefined` en el tipo devuelto (tipo nuevo
+  `BrandMessagesNamespace`); para los espacios obligatorios no cambia nada.
+- Test de tipos (`BrandMessages.types.test.ts`): compila con el compilador de TypeScript un catálogo
+  sin `appHeader` contra `BrandMessages`, con un caso de control que sí debe fallar.
+- Revisado el resto de 49.23.0: no añadió ningún otro campo obligatorio a tipos públicos (las props
+  nuevas de `AppHeader` ya eran opcionales).
+
 ## [49.23.0] — 2026-10-04
 
 > **Minor.** Ranura `logo` en `AppHeader`, a petición de Homenize. Espacio nuevo `appHeader` en

package/dist/_shared/brandmessagescontext.js

@@ -4,10 +4,10 @@ var n = e(null);
 function r(e) {
 	let r = t(n);
 	return function(t, n) {
-		if (n !== void 0) return n;
+		if (n != null) return n;
 		if (!r) throw Error(`@studiolxd/brand: falta el texto «${String(e)}.${String(t)}» y no hay catálogo montado. Monta <BrandMessagesProvider> en la raíz de la aplicación con los textos del idioma vigente, o pasa la prop suelta en este uso concreto.`);
 		let i = r[e]?.[t];
-		if (i === void 0) throw Error(`@studiolxd/brand: el catálogo montado no trae «${String(e)}.${String(t)}».`);
+		if (i == null) throw Error(`@studiolxd/brand: el catálogo montado no trae «${String(e)}.${String(t)}».`);
 		return i;
 	};
 }

package/dist/_types/messages/BrandMessages.d.ts

@@ -143,7 +143,13 @@ export interface BrandMessages {
     menuButton: MenuButtonMessages;
     appRoot: AppRootMessages;
     appShell: AppShellMessages;
-    appHeader: AppHeaderMessages;
+    /**
+     * **Opcional** (desde v49.23.1): solo lo lee el `AppHeader` cuando lleva
+     * `logo` y no recibe `logoLabel`. En v49.23.0 entró obligatorio y rompía la
+     * compilación de catálogos que no usan el logo. Si un `AppHeader` lo
+     * necesita y falta, lanza como cualquier otra clave ausente.
+     */
+    appHeader?: AppHeaderMessages;
     sidebar: SidebarMessages;
     sidebarNav: SidebarNavMessages;
     siteNav: SiteNavMessages;

package/dist/_types/messages/BrandMessagesContext.d.ts

@@ -11,8 +11,14 @@ export declare const BrandMessagesContext: import("react").Context<BrandMessages
  * consumidor la pasa.
  */
 export interface BrandMessagesReader<K extends keyof BrandMessages> {
-    <N extends keyof BrandMessages[K]>(key: N, override?: BrandMessages[K][N]): BrandMessages[K][N];
+    <N extends keyof BrandMessagesNamespace<K>>(key: N, override?: BrandMessagesNamespace<K>[N]): NonNullable<BrandMessagesNamespace<K>[N]>;
 }
+/**
+ * El espacio de un componente, sin el `undefined` de los espacios opcionales
+ * (`appHeader`): el lector nunca devuelve `undefined`, porque si el texto
+ * falta lanza.
+ */
+export type BrandMessagesNamespace<K extends keyof BrandMessages> = NonNullable<BrandMessages[K]>;
 /**
  * El lector del espacio de un componente. Se llama **en el punto donde el
  * texto se pinta**, no al principio del render: así un componente que no

package/dist/_types/messages/index.d.ts

@@ -1,5 +1,5 @@
 export { BrandMessagesProvider } from './BrandMessagesProvider';
 export type { BrandMessagesProviderProps } from './BrandMessagesProvider';
 export { useBrandMessages } from './BrandMessagesContext';
-export type { BrandMessagesReader } from './BrandMessagesContext';
+export type { BrandMessagesReader, BrandMessagesNamespace } from './BrandMessagesContext';
 export type { BrandMessages, PaginationMessages, TableMessages, DataTableMessages, InputFieldMessages, PasswordFieldMessages, SelectMessages, MultiSelectMessages, NumberInputMessages, OtpInputMessages, InputPhoneMessages, AsyncSelectMessages, AsyncMultiSelectMessages, DocsSearchMessages, SearchFormMessages, SiteSearchMessages, FilterBarMessages, CalendarMessages, DatePickerMessages, ColorPickerMessages, TimeSelectMessages, FileUploadMessages, ImageCropDialogMessages, AvatarUploadMessages, ModalMessages, SheetMessages, ConfirmDialogMessages, AlertMessages, BannerMessages, ToasterMessages, ConsentMessages, CommandPaletteMessages, AppLauncherMessages, FloatingDockMessages, NotificationButtonMessages, NotificationPanelMessages, MenuButtonMessages, AppRootMessages, AppShellMessages, AppHeaderMessages, SidebarMessages, SidebarNavMessages, SiteNavMessages, SiteHeaderMessages, UserMenuMessages, OrgSwitcherMessages, BreadcrumbMessages, TableOfContentsMessages, PrevNextNavMessages, PublicPageShellMessages, OnboardingShellMessages, CopyMessages, CodeBlockMessages, DotsButtonMessages, ProgressBarMessages, SpinnerMessages, SliderMessages, TreeViewMessages, ClockWidgetMessages, HeatmapMessages, OrgChartMessages, PlanningGridMessages, RecurrenceFieldMessages, TimelineMessages, UptimeBarsMessages, ChartMessages, StepperMessages, CarouselMessages, LanguageSwitcherMessages, ProjectCardMessages, LegalFooterMessages, CalendarRosterMessages, CalendarPlannerMessages, NotificationListMessages, MessageComposerMessages, ConversationListMessages, ConversationThreadMessages, TypingIndicatorMessages, AnnotationThreadMessages, ChatShellMessages, UntrustedTextMessages, ConnectorRequestSummaryMessages, ConnectorConsentMessages, ConnectorSignInMessages, ConnectorExternalSignInMessages, ConnectorRejectionMessages, } from './BrandMessages';

package/dist/_types/sections/AppHeader/AppHeader.d.ts

@@ -12,8 +12,11 @@ export type AppHeaderLogoLinkProps = {
  * que `siteHeader.logo`.
  */
 export interface AppHeaderMessages {
-    /** Texto accesible del enlace del logotipo. */
-    logo: string;
+    /**
+     * Texto accesible del enlace del logotipo. Opcional, como el espacio entero:
+     * solo hace falta si algún `AppHeader` lleva `logo` sin `logoLabel`.
+     */
+    logo?: string;
 }
 export interface AppHeaderProps {
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@studiolxd/brand",
-  "version": "49.23.0",
+  "version": "49.23.1",
   "description": "El sistema de diseño de Studio LXD: componentes React, tokens y documentación de la suite SLXD.",
   "repository": {
     "type": "git",