@lupinum/ginko-docs 0.3.0 → 0.4.0-rc.10

package/shared/types/app-config.ts

@@ -1,5 +1,7 @@
 export type { GinkoDocsNeutralPalette, GinkoDocsPrimaryPalette } from "../theme-palettes";
+export type { GinkoDocsThemePreset } from "../theme-presets";
 import type { GinkoDocsNeutralPalette, GinkoDocsPrimaryPalette } from "../theme-palettes";
+import type { GinkoDocsThemePreset } from "../theme-presets";
 
 export type GinkoDocsLocalizedText = string | { en: string; de?: string };
 
@@ -56,11 +58,25 @@ export interface GinkoDocsHeroCodeTab {
 
 export type GinkoDocsHeroMedia =
   | { type: "image"; src: string; alt: string }
-  | { type: "code"; code: string; language?: string; filename?: string }
-  | { type: "code-tabs"; tabs: GinkoDocsHeroCodeTab[] };
+  | {
+      type: "code";
+      code: string;
+      language?: string;
+      filename?: string;
+      /** Let the code panel use otherwise empty viewport space on wide screens. */
+      layout?: "wide";
+    }
+  | {
+      type: "code-tabs";
+      tabs: GinkoDocsHeroCodeTab[];
+      /** Let the code panel use otherwise empty viewport space on wide screens. */
+      layout?: "wide";
+    };
 
 export interface GinkoDocsAppConfig {
   theme: {
+    /** Coordinated visual system. A non-default preset owns palette and surface tokens. */
+    preset?: GinkoDocsThemePreset;
     neutral: GinkoDocsNeutralPalette;
     primary: GinkoDocsPrimaryPalette;
     codeBlocks: GinkoDocsCodeBlockTheme;
@@ -70,6 +86,8 @@ export interface GinkoDocsAppConfig {
     name: GinkoDocsLocalizedText;
     description: GinkoDocsLocalizedText;
     url: string;
+    /** Square product mark used for browser icons and generated social cards. */
+    icon: string;
     logo: { light: string; dark: string };
     docsSidebarSwitcher: "dropdown" | "list" | "tabs";
     lupinumAttribution: boolean;

package/shared/types/nuxt-config.ts

@@ -1,4 +1,5 @@
 import type { BundledTheme } from "shiki";
+import type { LocaleCode } from "../../i18n/locales";
 
 export type GinkoDocsSyntaxTheme = BundledTheme;
 
@@ -10,5 +11,7 @@ export interface GinkoDocsSyntaxHighlightingConfig {
 }
 
 export interface GinkoDocsNuxtConfig {
+  /** Locale that owns unprefixed routes. */
+  primaryLocale?: LocaleCode;
   syntaxHighlighting?: GinkoDocsSyntaxHighlightingConfig;
 }