create-zudo-doc 0.2.4 → 0.2.5

package/dist/constants.js

@@ -217,7 +217,7 @@ export const FEATURES = [
         value: "tagGovernance",
         label: "Tag governance",
         hint: "Vocabulary-aware tag audit + suggest scripts",
-        default: true,
+        default: false,
         cliFlag: "tag-governance",
     },
     {

package/dist/features/doc-history.js

@@ -7,5 +7,61 @@
  */
 export const docHistoryFeature = () => ({
     name: "docHistory",
-    injections: [],
+    injections: [
+        {
+            // Diff-viewer CSS — the DocHistory island's side-by-side diff markup
+            // (.diff-row / .diff-line-*) is styled only here; without this block
+            // scaffolded projects render the diff viewer unstyled (#2081). Values
+            // mirror the showcase src/styles/global.css (per-line separators at
+            // the 15% muted mix, #2077).
+            file: "src/styles/global.css",
+            anchor: "/* @slot:global-css:feature-styles */",
+            content: `/* ========================================
+ * Doc History Diff Viewer (side-by-side)
+ * ======================================== */
+
+.diff-row {
+  border-bottom: 1px solid color-mix(in oklch, var(--color-muted) 15%, transparent);
+}
+
+.diff-line-num {
+  font-family: var(--font-mono, ui-monospace, monospace);
+  font-size: var(--text-caption);
+  line-height: 1.5;
+  padding: 0 var(--spacing-hsp-xs);
+  text-align: right;
+  color: var(--color-muted);
+  user-select: none;
+  vertical-align: top;
+  border-right: 1px solid color-mix(in oklch, var(--color-muted) 15%, transparent);
+}
+
+.diff-line-content {
+  font-family: var(--font-mono, ui-monospace, monospace);
+  font-size: var(--text-caption);
+  line-height: 1.5;
+  padding: 0 var(--spacing-hsp-sm);
+  white-space: pre-wrap;
+  word-break: break-all;
+  vertical-align: top;
+}
+
+/* Left column right border to separate the two sides */
+.diff-row td:nth-child(2) {
+  border-right: 2px solid var(--color-muted);
+}
+
+.diff-line-added {
+  background-color: color-mix(in oklch, var(--color-success) 15%, transparent);
+}
+
+.diff-line-removed {
+  background-color: color-mix(in oklch, var(--color-danger) 15%, transparent);
+}
+
+.diff-line-empty {
+  background-color: color-mix(in oklch, var(--color-muted) 8%, transparent);
+}`,
+        },
+    ],
 });

package/dist/preset.d.ts

@@ -17,6 +17,15 @@ export interface PresetHeaderRightTriggerItem {
     trigger: PresetHeaderRightTriggerName;
 }
 export type PresetHeaderRightItem = PresetHeaderRightComponentItem | PresetHeaderRightTriggerItem;
+export interface PresetMetaTagsConfig {
+    description?: boolean;
+    keywords?: string | false;
+    ogImage?: string | false;
+    ogSiteName?: boolean;
+    twitterCard?: "summary" | "summary_large_image" | false;
+    twitterSite?: string;
+    twitterCreator?: string;
+}
 export interface PresetJson {
     projectName?: string;
     defaultLang?: string;
@@ -31,6 +40,7 @@ export interface PresetJson {
     cjkFriendly?: boolean;
     packageManager?: "pnpm" | "npm" | "yarn" | "bun";
     headerRightItems?: PresetHeaderRightItem[];
+    metaTags?: PresetMetaTagsConfig;
 }
 export declare function loadPreset(pathOrStdin: string): PartialChoices;
 export declare function validatePreset(json: unknown): string | null;

package/dist/preset.js

@@ -112,6 +112,36 @@ export function validatePreset(json) {
             }
         }
     }
+    if (p.metaTags !== undefined) {
+        if (typeof p.metaTags !== "object" || p.metaTags === null || Array.isArray(p.metaTags)) {
+            return `"metaTags" must be an object in preset`;
+        }
+        const mt = p.metaTags;
+        if (mt.description !== undefined && typeof mt.description !== "boolean") {
+            return `"metaTags.description" must be a boolean`;
+        }
+        if (mt.keywords !== undefined && mt.keywords !== false && typeof mt.keywords !== "string") {
+            return `"metaTags.keywords" must be a string or false`;
+        }
+        if (mt.ogImage !== undefined && mt.ogImage !== false && typeof mt.ogImage !== "string") {
+            return `"metaTags.ogImage" must be a string or false`;
+        }
+        if (mt.ogSiteName !== undefined && typeof mt.ogSiteName !== "boolean") {
+            return `"metaTags.ogSiteName" must be a boolean`;
+        }
+        if (mt.twitterCard !== undefined &&
+            mt.twitterCard !== false &&
+            mt.twitterCard !== "summary" &&
+            mt.twitterCard !== "summary_large_image") {
+            return `"metaTags.twitterCard" must be "summary", "summary_large_image", or false`;
+        }
+        if (mt.twitterSite !== undefined && typeof mt.twitterSite !== "string") {
+            return `"metaTags.twitterSite" must be a string`;
+        }
+        if (mt.twitterCreator !== undefined && typeof mt.twitterCreator !== "string") {
+            return `"metaTags.twitterCreator" must be a string`;
+        }
+    }
     // Cross-field validation
     if (p.colorSchemeMode === "single" && (p.lightScheme || p.darkScheme)) {
         return `lightScheme/darkScheme are only valid with colorSchemeMode "light-dark"`;
@@ -150,6 +180,9 @@ export function presetToChoices(json) {
     if (json.headerRightItems !== undefined) {
         choices.headerRightItems = json.headerRightItems;
     }
+    if (json.metaTags !== undefined) {
+        choices.metaTags = json.metaTags;
+    }
     if (json.features) {
         // Warn about unrecognized feature names
         for (const name of json.features) {

package/dist/prompts.d.ts

@@ -1,4 +1,4 @@
-import type { PresetHeaderRightItem } from "./preset.js";
+import type { PresetHeaderRightItem, PresetMetaTagsConfig } from "./preset.js";
 export interface UserChoices {
     projectName: string;
     defaultLang: string;
@@ -14,6 +14,7 @@ export interface UserChoices {
     cjkFriendly?: boolean;
     packageManager: "pnpm" | "npm" | "yarn" | "bun";
     headerRightItems?: PresetHeaderRightItem[];
+    metaTags?: PresetMetaTagsConfig;
 }
 export interface PartialChoices {
     projectName?: string;
@@ -30,5 +31,6 @@ export interface PartialChoices {
     cjkFriendly?: boolean;
     packageManager?: "pnpm" | "npm" | "yarn" | "bun";
     headerRightItems?: PresetHeaderRightItem[];
+    metaTags?: PresetMetaTagsConfig;
 }
 export declare function runPrompts(prefilled?: PartialChoices): Promise<UserChoices>;

package/dist/prompts.js

@@ -241,5 +241,6 @@ export async function runPrompts(prefilled = {}) {
         cjkFriendly: prefilled.cjkFriendly,
         packageManager,
         headerRightItems: prefilled.headerRightItems,
+        metaTags: prefilled.metaTags,
     };
 }

package/dist/scaffold.js

@@ -283,16 +283,18 @@ function generatePackageJson(choices) {
         // (Takazudo/zudo-front-builder#1030) — and the data-file skip warning
         // (e.g. for `_category_.json`) now respects the collection's
         // include/exclude globs (#1032). No consumer-facing breaking change.
-        "@takazudo/zfb": "0.1.0-next.41",
-        "@takazudo/zfb-runtime": "0.1.0-next.41",
+        // next.42/next.43: release-tooling + formatter-glob fixes only (npm-publish
+        // idempotency, gitignored-artifact excludes). No consumer-facing change.
+        "@takazudo/zfb": "0.1.0-next.43",
+        "@takazudo/zfb-runtime": "0.1.0-next.43",
         // zfb-adapter-cloudflare — required for any route with `prerender = false`.
         // Pinned in lockstep with @takazudo/zfb.
-        "@takazudo/zfb-adapter-cloudflare": "0.1.0-next.41",
+        "@takazudo/zfb-adapter-cloudflare": "0.1.0-next.43",
         // @takazudo/zudo-doc — published from this monorepo via
         // .github/workflows/publish-zudo-doc.yml. The pin here is bumped in
         // lockstep by scripts/release-create-zudo-doc.sh whenever zudo-doc's
         // version moves, so a fresh scaffold pulls the version we just published.
-        "@takazudo/zudo-doc": "^0.2.4",
+        "@takazudo/zudo-doc": "^0.2.5",
         // zod — used by the generated zfb.config.ts. zfb-config-gen emits
         // `import { z } from "zod"` for the content-collection schema +
         // `z.toJSONSchema(...)` conversion. Without this dep, the consumer
@@ -346,7 +348,7 @@ function generatePackageJson(choices) {
         // @takazudo/zudo-doc/integrations/doc-history which in turn imports
         // @takazudo/zudo-doc-history-server/git-history. Without this dep the
         // plugin host fails at init with ERR_MODULE_NOT_FOUND — W8A (#1739).
-        deps["@takazudo/zudo-doc-history-server"] = "^0.2.4";
+        deps["@takazudo/zudo-doc-history-server"] = "^0.2.5";
         // W7A (#1736): doc-history-plugin.mjs spawns `tsx -e <inline-script>` to
         // run the v2 runtime in a TS-aware Node subprocess; without tsx the
         // plugin's preBuild step exits with ENOENT before zfb finishes config

package/dist/settings-gen.js

@@ -16,6 +16,7 @@ export function generateSettingsFile(choices) {
     lines.push(`  TagPlacement,`);
     lines.push(`  TagGovernanceMode,`);
     lines.push(`  TagVocabularyEntry,`);
+    lines.push(`  MetaTagsConfig,`);
     lines.push(`} from "./settings-types";`);
     lines.push(`import type {`);
     lines.push(`  HeaderNavItem,`);
@@ -29,6 +30,7 @@ export function generateSettingsFile(choices) {
     lines.push(`  BodyFootUtilAreaConfig,`);
     lines.push(`  TagPlacement,`);
     lines.push(`  TagGovernanceMode,`);
+    lines.push(`  MetaTagsConfig,`);
     lines.push(`} from "./settings-types";`);
     lines.push(``);
     lines.push(`export const settings = {`);
@@ -59,6 +61,34 @@ export function generateSettingsFile(choices) {
         lines.push(`  githubUrl: false as string | false,`);
     }
     lines.push(`  siteUrl: "" as string,`);
+    lines.push(`  metaTags: {`);
+    if (choices.metaTags) {
+        const mt = choices.metaTags;
+        lines.push(`    description: ${mt.description !== undefined ? mt.description : true},`);
+        lines.push(`    keywords: ${mt.keywords !== undefined ? JSON.stringify(mt.keywords) : false},`);
+        lines.push(`    ogImage: ${mt.ogImage !== undefined ? JSON.stringify(mt.ogImage) : false},`);
+        lines.push(`    ogSiteName: ${mt.ogSiteName !== undefined ? mt.ogSiteName : true},`);
+        if (mt.twitterCard) {
+            lines.push(`    twitterCard: ${JSON.stringify(mt.twitterCard)},`);
+            if (mt.twitterSite) {
+                lines.push(`    twitterSite: ${JSON.stringify(mt.twitterSite)},`);
+            }
+            if (mt.twitterCreator) {
+                lines.push(`    twitterCreator: ${JSON.stringify(mt.twitterCreator)},`);
+            }
+        }
+        else {
+            lines.push(`    twitterCard: false,`);
+        }
+    }
+    else {
+        lines.push(`    description: true,`);
+        lines.push(`    keywords: false,`);
+        lines.push(`    ogImage: false,`);
+        lines.push(`    ogSiteName: true,`);
+        lines.push(`    twitterCard: false,`);
+    }
+    lines.push(`  } satisfies MetaTagsConfig as MetaTagsConfig,`);
     lines.push(`  docsDir: "src/content/docs",`);
     lines.push(`  defaultLocale: ${JSON.stringify(choices.defaultLang ?? "en")} as const,`);
     if (choices.features.includes("i18n")) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-zudo-doc",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Create a new zudo-doc documentation site",
   "license": "MIT",
   "author": "Takeshi Takatsudo",

package/templates/base/pages/_mdx-components.ts

@@ -40,10 +40,11 @@
 import type { ComponentChildren } from "preact";
 // @slot:mdx-components:enlarge-imports
 import { htmlOverrides } from "@takazudo/zudo-doc/content";
-import { HtmlPreviewWrapper } from "@takazudo/zudo-doc/html-preview-wrapper";
+import { HtmlPreviewWrapper, type HtmlPreviewWrapperProps } from "@takazudo/zudo-doc/html-preview-wrapper";
 import { Tabs } from "@takazudo/zudo-doc/code-syntax";
 import { TabItem } from "@takazudo/zudo-doc/tab-item";
 import { defaultLocale, type Locale } from "@/config/i18n";
+import { settings } from "@/config/settings";
 import { withBase } from "@/utils/base";
 import { CategoryNavWrapper } from "./lib/_category-nav";
 import { CategoryTreeNavWrapper } from "./lib/_category-tree-nav";
@@ -120,6 +121,9 @@ function IslandWrapper(props: {
 }
 
 // @slot:mdx-components:enlarge-defs
+const HtmlPreviewWithGlobalConfig = (props: HtmlPreviewWrapperProps) =>
+  HtmlPreviewWrapper({ globalConfig: settings.htmlPreview ?? null, ...props });
+
 /**
  * Build a locale-aware MDX components map for the given locale.
  *
@@ -164,7 +168,7 @@ export function createMdxComponents(lang: Locale | string = defaultLocale) {
     // site. withBase() is generic — any configured base value works.
     img: ContentImg,
     // @slot:mdx-components:enlarge-p-entry
-    HtmlPreview: HtmlPreviewWrapper,
+    HtmlPreview: HtmlPreviewWithGlobalConfig,
     // Admonitions — real typed Preact components (src/components/content/
     // content-admonition.tsx) emitting the `.admonition` / `data-admonition`
     // structure the design-system CSS targets. The `directives` map in

package/templates/base/pages/lib/_doc-page-shell.tsx

@@ -176,7 +176,9 @@ export function DocPageShell(props: DocPageShellProps): JSX.Element {
   return (
     <DocLayoutWithDefaults
       title={composeMetaTitle(title)}
-      description={description}
+      // Plain <meta name="description"> is emitted by DocLayout from this prop —
+      // gate it here alongside the og:description gate inside HeadWithDefaults (#2078)
+      description={settings.metaTags.description ? description : undefined}
       head={<HeadWithDefaults title={title} description={description} canonical={canonical} />}
       lang={locale}
       noindex={settings.noindex}

package/templates/base/pages/lib/_head-with-defaults.tsx

@@ -63,6 +63,10 @@ export interface HeadWithDefaultsProps {
  * (the legacy Astro layout produced both shapes; the zfb host has to
  * compose them itself).
  *
+ * og:title is always emitted — it is the unconditional DocHead contract
+ * (OgTags always emits og:title regardless of settings). All other tags
+ * are gated by settings.metaTags.
+ *
  * Pure SSR — no state, no client-only imports. Intended for use as:
  *   head={<HeadWithDefaults title={title} description={description} canonical={canonical} />}
  * on every DocLayoutWithDefaults call site in the host pages.
@@ -72,6 +76,8 @@ export function HeadWithDefaults({
   description,
   canonical,
 }: HeadWithDefaultsProps): JSX.Element {
+  const { metaTags } = settings;
+
   // og:image / twitter:image must be absolute URLs — crawlers silently drop
   // relative og:image values. absoluteUrl joins siteUrl (no trailing slash) +
   // the base-prefixed asset path, and returns undefined when siteUrl is empty
@@ -80,7 +86,10 @@ export function HeadWithDefaults({
   // TwitterCard already gate their image emission on the prop being defined;
   // the og:image:* companion tags below are gated explicitly because they
   // would dangle without the parent og:image.
-  const ogImageUrl = absoluteUrl(withBase("/img/ogp.png"));
+  const ogImageUrl =
+    metaTags.ogImage !== false
+      ? absoluteUrl(withBase(metaTags.ogImage))
+      : undefined;
 
   // Resolve the palette CSS body once per page render (the v2 component
   // is pure SSR — no caching needed).
@@ -93,12 +102,15 @@ export function HeadWithDefaults({
     <>
       <OgTags
         title={composeMetaTitle(title)}
-        description={description}
+        description={metaTags.description ? description : undefined}
         ogType="website"
         ogUrl={canonical}
         ogImage={ogImageUrl}
-        ogSiteName={settings.siteName}
+        ogSiteName={metaTags.ogSiteName ? settings.siteName : undefined}
       />
+      {metaTags.keywords !== false && metaTags.keywords.length > 0 && (
+        <meta name="keywords" content={metaTags.keywords} />
+      )}
       {/* og:image:width / og:image:height / og:image:alt — not in OgTags API;
           emitted here directly to avoid expanding the shared HeadProps surface.
           Standard 1200×630 social preview dimensions. Gated on ogImageUrl so
@@ -110,7 +122,14 @@ export function HeadWithDefaults({
           <meta property="og:image:alt" content={composeMetaTitle(title)} />
         </>
       )}
-      <TwitterCard card="summary_large_image" image={ogImageUrl} />
+      {metaTags.twitterCard !== false && (
+        <TwitterCard
+          card={metaTags.twitterCard}
+          image={ogImageUrl}
+          site={metaTags.twitterSite}
+          creator={metaTags.twitterCreator}
+        />
+      )}
       <ColorSchemeProvider cssText={cssText} colorMode={colorMode} />
       {/* Pre-paint inline script: restore persisted sidebar width to
           --zd-sidebar-w on :root before first paint, so a reload after

package/templates/base/src/config/settings-types.ts

@@ -160,3 +160,20 @@ export interface VersionConfig {
   /** Banner text shown on versioned pages (e.g., "unmaintained", "unreleased") */
   banner?: "unmaintained" | "unreleased" | false;
 }
+
+export interface MetaTagsConfig {
+  /** Emit <meta name="description">. Default true. */
+  description: boolean;
+  /** Emit <meta name="keywords"> with a comma-separated string. false = omit. Default false. */
+  keywords: string | false;
+  /** og:image (and twitter:image) path. false = omit. Default false. Showcase: '/img/ogp.png'. */
+  ogImage: string | false;
+  /** Emit og:site_name. Default true (preserves current og:site_name). */
+  ogSiteName: boolean;
+  /** TwitterCard type. false = omit entire twitter:card block. Default false. Showcase: 'summary_large_image'. */
+  twitterCard: "summary" | "summary_large_image" | false;
+  /** twitter:site handle (e.g. '@yourbrand'). Optional. */
+  twitterSite?: string;
+  /** twitter:creator handle. Optional. */
+  twitterCreator?: string;
+}

package/templates/base/src/styles/global.css

@@ -1,4 +1,15 @@
-@import "tailwindcss/preflight";
+/* Cascade-layer order for the flow-space fix (zudolab/zudo-doc#2082 / #2109):
+ *   zd-preflight  — Tailwind's preflight reset (incl. `* { margin: 0 }`)
+ *   zd-flow       — the .zd-content flow-space margin-top rule (below)
+ *   (unlayered)   — `tailwindcss/utilities` (mt-* etc.) — highest priority
+ * Unlayered always beats any layer, so `mt-*` utilities win over the flow
+ * rule; the flow rule (zd-flow) sits above zd-preflight so it still beats the
+ * preflight `margin: 0` reset and the .zd-content vertical rhythm is preserved.
+ * Preflight is the de-facto lowest-priority origin already, so moving it into
+ * the lowest layer is observably inert for every other author rule (which stay
+ * unlayered and continue to outrank it). */
+@layer zd-preflight, zd-flow;
+@import "tailwindcss/preflight" layer(zd-preflight);
 @import "tailwindcss/utilities";
 
 /* ========================================
@@ -263,8 +274,21 @@ body {
 
 /* ── Flow spacing (vertical rhythm) ── */
 
-.zd-content > :where(* + *) {
-  margin-top: var(--flow-space, var(--spacing-vsp-md));
+/* In the `zd-flow` cascade layer (declared at the top of this file) so the
+ * unlayered `tailwindcss/utilities` import wins over it: unlayered declarations
+ * always beat layered ones regardless of specificity or source order. Both this
+ * rule and a `mt-*` utility have specificity (0,1,0); without the layer this
+ * rule comes later in source order and silently kills every `mt-*` on a
+ * `.zd-content` direct child. zd-flow sits ABOVE zd-preflight so this rule still
+ * beats preflight's `* { margin: 0 }` reset and the .zd-content rhythm is
+ * preserved for plain content blocks. The layer is scoped to ONLY this flow rule
+ * — every other `.zd-content` author rule (links, code, lists, headings, the
+ * `:first-child` reset, etc.) stays unlayered so utilities do NOT flip those.
+ * See zudolab/zudo-doc#2082 / #2109. */
+@layer zd-flow {
+  .zd-content > :where(* + *) {
+    margin-top: var(--flow-space, var(--spacing-vsp-md));
+  }
 }
 
 /* ── Headings ── */
@@ -938,7 +962,17 @@ pre[class^="syntect-"] .line .highlighted-word {
  * article, TOC, etc.). The twelve ::view-transition-{old,new,group}(<name>)
  * rules disable animation for all four chrome layers. The group pseudo must be
  * neutralised too — even when old/new are static the group container can still
- * produce a geometry-morph animation when snapshot size/position differs. */
+ * produce a geometry-morph animation when snapshot size/position differs.
+ *
+ * Entry/exit cross-fade (zudolab/zudo-doc#2072): animation: none is only
+ * correct when the chrome element exists on BOTH pages of a navigation.
+ * When it exists on one side only (docs page with sidebar → top page
+ * without), the named group holds a single snapshot — frozen at full
+ * opacity for the whole transition, then dropped abruptly at finish. The
+ * :only-child rules below detect that one-sided case and cross-fade the
+ * lone snapshot in sync with the root content fade (spec-standard
+ * entry/exit pattern; :only-child outranks the animation: none rules via
+ * the extra pseudo-class specificity). */
 
 /* Chrome extraction — assign view-transition-name from data-zfb-transition-persist */
 [data-zfb-transition-persist^="header-"]               { view-transition-name: zfb-header; }
@@ -960,6 +994,22 @@ pre[class^="syntect-"] .line .highlighted-word {
 ::view-transition-new(zfb-sidebar-toggle),
 ::view-transition-group(zfb-sidebar-toggle) { animation: none; }
 
+/* Entry/exit: chrome element present on one side only (#2072).
+ * Exit — lone old snapshot fades out with the content cross-fade. */
+::view-transition-old(zfb-header):only-child,
+::view-transition-old(zfb-sidebar):only-child,
+::view-transition-old(zfb-footer):only-child,
+::view-transition-old(zfb-sidebar-toggle):only-child {
+  animation: 150ms ease-in both contentFadeOut;
+}
+/* Entry — lone new snapshot fades in with the content cross-fade. */
+::view-transition-new(zfb-header):only-child,
+::view-transition-new(zfb-sidebar):only-child,
+::view-transition-new(zfb-footer):only-child,
+::view-transition-new(zfb-sidebar-toggle):only-child {
+  animation: 300ms ease-out both contentFadeIn;
+}
+
 /* Root cross-fade rules — animate only the non-chrome snapshot */
 ::view-transition-old(root) {
   animation: 150ms ease-in both contentFadeOut;
@@ -968,6 +1018,27 @@ pre[class^="syntect-"] .line .highlighted-word {
   animation: 300ms ease-out both contentFadeIn;
 }
 
+/* Reduced motion: collapse all view-transition animation to an instant
+ * swap (zudolab/zudo-doc#2086). With every snapshot animation at none the
+ * transition settles immediately — no cross-fade, no translateY slide.
+ * Covers the root cross-fade and the #2072 :only-child entry/exit rules;
+ * the both-sides chrome layers are already animation: none above. Equal
+ * specificity per selector, but later in source order, so these win. */
+@media (prefers-reduced-motion: reduce) {
+  ::view-transition-old(root),
+  ::view-transition-new(root),
+  ::view-transition-old(zfb-header):only-child,
+  ::view-transition-old(zfb-sidebar):only-child,
+  ::view-transition-old(zfb-footer):only-child,
+  ::view-transition-old(zfb-sidebar-toggle):only-child,
+  ::view-transition-new(zfb-header):only-child,
+  ::view-transition-new(zfb-sidebar):only-child,
+  ::view-transition-new(zfb-footer):only-child,
+  ::view-transition-new(zfb-sidebar-toggle):only-child {
+    animation: none;
+  }
+}
+
 /* Version-switcher responsive visibility (moved out of the component to
  * avoid <style>-inside-<div> HTML5 content-model violation; required when
  * the i18nVersion feature ships a <VersionSwitcher> wrapped in