@@ -49,6 +49,8 @@ export interface PageMessagesOptions extends MessageCatalogsOptions {
4949 * first of `languages`.
5050 */
5151 fallback ?: string
52+ /** Additional languages available for in-place switching, without fetching a page. */
53+ preload ?: 'all' | string [ ]
5254}
5355
5456export interface CollectedMessages {
@@ -107,6 +109,7 @@ export interface PageMessages extends CollectedMessages {
107109 stubs : Map < string , string >
108110 languages : string [ ]
109111 fallback : string
112+ preload ?: string [ ]
110113}
111114
112115const collected = new Map < string , { signature : string , messages : PageMessages } > ( )
@@ -146,7 +149,7 @@ export async function loadPageMessages(root: string, options: PageMessagesOption
146149 try { return `${ language } :${ statSync ( path . join ( dir , language ) ) . mtimeMs } ` }
147150 catch { return `${ language } :-` }
148151 } ) . join ( '|' )
149- const cacheKey = `${ dir } \0${ options . languages . join ( ',' ) } \0${ options . fallback ?? '' } `
152+ const cacheKey = `${ dir } \0${ options . languages . join ( ',' ) } \0${ options . fallback ?? '' } \0 ${ JSON . stringify ( options . preload ?? [ ] ) } `
150153 const cached = collected . get ( cacheKey )
151154 if ( cached && cached . signature === signature ) return cached . messages
152155 const catalogs = await collectMessageCatalogs ( root , options )
@@ -157,7 +160,11 @@ export async function loadPageMessages(root: string, options: PageMessagesOption
157160 }
158161 const fallback = options . fallback ?? options . languages [ 0 ] !
159162 if ( ! options . languages . includes ( fallback ) ) throw new Error ( `messages.fallback "${ fallback } " is not one of messages.languages` )
160- const messages = { ...catalogs , stubs, languages : [ ...options . languages ] , fallback }
163+ const preload = options . preload === 'all' ? [ ...options . languages ] : [ ...( options . preload ?? [ ] ) ]
164+ for ( const language of preload ) {
165+ if ( ! options . languages . includes ( language ) ) throw new Error ( `messages.preload "${ language } " is not one of messages.languages` )
166+ }
167+ const messages = { ...catalogs , stubs, languages : [ ...options . languages ] , fallback, preload }
161168 collected . set ( cacheKey , { signature, messages } )
162169 return messages
163170}
@@ -178,14 +185,14 @@ export function messageAreasIn(...codes: Array<string | null | undefined>): Set<
178185 * Every language when the page names none of them, since nothing then says
179186 * which one its scripts will read.
180187 */
181- export function pageLanguages ( html : string , messages : Pick < PageMessages , 'languages' | 'fallback' > ) : string [ ] {
188+ export function pageLanguages ( html : string , messages : Pick < PageMessages , 'languages' | 'fallback' | 'preload' > ) : string [ ] {
182189 const htmlTag = / < h t m l \b [ ^ > ] * > / i. exec ( html ) ?. [ 0 ] ?? ''
183190 const lang = / \s l a n g \s * = \s * (?: " ( [ ^ " ] * ) " | ' ( [ ^ ' ] * ) ' | ( [ ^ \s > ] + ) ) / i. exec ( htmlTag )
184191 const value = ( lang ? ( lang [ 1 ] ?? lang [ 2 ] ?? lang [ 3 ] ?? '' ) : '' ) . trim ( ) . toLowerCase ( )
185192 const known = new Map ( messages . languages . map ( language => [ language . toLowerCase ( ) , language ] ) )
186193 const language = known . get ( value ) ?? known . get ( value . split ( / [ - _ ] / ) [ 0 ] ?? '' )
187194 if ( ! language ) return [ ...messages . languages ]
188- return [ ...new Set ( [ language , messages . fallback ] ) ]
195+ return [ ...new Set ( [ language , messages . fallback , ... ( messages . preload ?? [ ] ) ] ) ]
189196}
190197
191198/**
0 commit comments