@lupinum/ginko-docs 0.2.2 → 0.2.3

package/i18n/messages/global/command.ts

@@ -19,10 +19,14 @@ export const command = {
     recent: { de: "Zuletzt", en: "Recent" },
     pages: { de: "Navigation", en: "Navigation" },
     docs_nav: { de: "Docs-Navigation", en: "Docs Navigation" },
-    blog: { de: "Blog-Ergebnisse", en: "Blog Results" },
-    docs: { de: "Docs-Ergebnisse", en: "Docs Results" },
+    search: { de: "Suchergebnisse", en: "Search results" },
     actions: { de: "Aktionen", en: "Actions" },
   },
+  loading: { de: "Suche läuft …", en: "Searching…" },
+  error: {
+    de: "Die Suche ist gerade nicht verfügbar. Versuche es erneut.",
+    en: "Search is temporarily unavailable. Please try again.",
+  },
   pages: {
     home: {
       title: { de: "Start", en: "Home" },

package/i18n/messages/global/docs.ts

@@ -14,6 +14,8 @@ export const docs = {
   copiedText: { de: "Text kopiert", en: "Copied text" },
   copyFailed: { de: "Kopieren fehlgeschlagen", en: "Copy failed" },
   codeSample: { de: "Codebeispiel", en: "Code sample" },
+  showAllLines: { de: "Alle {count} Zeilen anzeigen", en: "Show all {count} lines" },
+  showMore: { de: "Mehr anzeigen", en: "Show more" },
   zoomImage: { de: "Bild vergrößern", en: "Zoom image" },
   moreActions: { de: "Weitere Seitenaktionen", en: "More page actions" },
   copyLink: { de: "Markdown-Link kopieren", en: "Copy Markdown link" },
@@ -22,6 +24,7 @@ export const docs = {
   askClaude: { de: "In Claude öffnen", en: "Open in Claude" },
   copyMcpUrl: { de: "MCP-Server-URL kopieren", en: "Copy MCP server URL" },
   contribute: { de: "Zu dieser Seite beitragen", en: "Contribute to this page" },
+  backToTop: { de: "Nach oben", en: "Back to top" },
   editPage: { de: "Diese Seite bearbeiten", en: "Edit this page" },
   reportIssue: { de: "Problem melden", en: "Report an issue" },
   issueTitle: { de: "Dokumentation: {title}", en: "Docs: {title}" },

package/i18n/messages/global/nav.ts

@@ -3,8 +3,12 @@ export const nav = {
   home: { de: "Startseite", en: "Home" },
   main: { de: "Hauptnavigation", en: "Main navigation" },
   mobile: { de: "Mobile Navigation", en: "Mobile navigation" },
-  navigationSection: { de: "Navigation", en: "Navigation" },
-  settingsHelp: { de: "Einstellungen & Hilfe", en: "Settings & Help" },
+  menu: { de: "Menü", en: "Menu" },
+  docsDescription: {
+    de: "Anleitungen, Komponenten, Referenz",
+    en: "Guides, components, reference",
+  },
+  blogDescription: { de: "Releases und Artikel", en: "Releases and writing" },
   language: { de: "Sprache wechseln", en: "Change language" },
   openMenu: { de: "Menü öffnen", en: "Open menu" },
   closeMenu: { de: "Menü schließen", en: "Close menu" },

package/i18n/messages/index.ts

@@ -1,19 +1,19 @@
 import { type LocaleCode, localeCodes } from "../locales";
 import { localizedRoutes } from "../routes";
+import { globalMessages } from "./global";
 import { localizeMessages } from "./localize";
-import { messageSource } from "./source";
 
 export const messages = localeCodes.reduce(
   (localizedMessages, locale) => {
     localizedMessages[locale] = {
-      ...localizeMessages(messageSource, locale),
+      ...localizeMessages(globalMessages, locale),
       routes: localizedRoutes[locale],
     };
     return localizedMessages;
   },
   {} as Record<
     LocaleCode,
-    ReturnType<typeof localizeMessages<typeof messageSource>> & {
+    ReturnType<typeof localizeMessages<typeof globalMessages>> & {
       routes: (typeof localizedRoutes)[LocaleCode];
     }
   >,

package/icon-bundle.ts

@@ -12,12 +12,14 @@ export const layerIconNames = [
   "logos:yarn",
   "lucide:arrow-left",
   "lucide:arrow-right",
+  "lucide:arrow-up",
   "lucide:arrow-up-right",
   "lucide:atom",
   "lucide:badge-check",
   "lucide:blocks",
   "lucide:book-open",
   "lucide:bookmark",
+  "lucide:calendar",
   "lucide:braces",
   "lucide:building-2",
   "lucide:check",
@@ -41,6 +43,8 @@ export const layerIconNames = [
   "lucide:file-json",
   "lucide:file-key",
   "lucide:file-text",
+  "lucide:folder",
+  "lucide:folder-open",
   "lucide:git-branch",
   "lucide:github",
   "lucide:hash",
@@ -49,6 +53,7 @@ export const layerIconNames = [
   "lucide:lightbulb",
   "lucide:link",
   "lucide:linkedin",
+  "lucide:loader-circle",
   "lucide:list",
   "lucide:menu",
   "lucide:message-circle",

package/index.d.ts

@@ -1,12 +1,18 @@
 import type { GinkoDocsAppConfig } from "./shared/types/app-config";
 
+type GinkoDocsAppConfigInput<T> = T extends readonly unknown[]
+  ? T
+  : T extends object
+    ? { [Key in keyof T]?: GinkoDocsAppConfigInput<T[Key]> }
+    : T;
+
 declare module "nuxt/schema" {
   interface AppConfig {
     ginkoDocs: GinkoDocsAppConfig;
   }
 
   interface AppConfigInput {
-    ginkoDocs?: Partial<GinkoDocsAppConfig>;
+    ginkoDocs?: GinkoDocsAppConfigInput<GinkoDocsAppConfig>;
   }
 }
 

package/nuxt.config.ts

@@ -41,7 +41,7 @@ export default defineNuxtConfig({
   },
   mcp: {
     name: "Ginko Docs",
-    version: "0.2.2",
+    version: "0.2.3",
   },
   components: {
     dirs: [
@@ -69,7 +69,6 @@ export default defineNuxtConfig({
       { path: join(app, "components/prose"), pathPrefix: false, global: true },
     ],
   },
-  imports: { autoImport: false },
   colorMode: { classSuffix: "" },
   icon: {
     provider: "none",
@@ -181,6 +180,7 @@ export default defineNuxtConfig({
         "@vueuse/core",
         "class-variance-authority",
         "clsx",
+        "motion-v",
         "reka-ui",
         "tailwind-merge",
         "zod",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lupinum/ginko-docs",
-  "version": "0.2.2",
-  "description": "A polished Nuxt documentation layer powered by Ginko Content.",
+  "version": "0.2.3",
+  "description": "A Nuxt documentation layer powered by Ginko Content.",
   "keywords": [
     "content",
     "documentation",
@@ -57,7 +57,7 @@
     "@nuxt/fonts": "^0.14.0",
     "@nuxt/icon": "^2.2.3",
     "@nuxt/image": "^2.0.0",
-    "@nuxt/kit": "^4.4.6",
+    "@nuxt/kit": "^4.4.7",
     "@nuxt/scripts": "^0.13.2",
     "@nuxtjs/color-mode": "^4.0.0",
     "@nuxtjs/i18n": "^10.4.0",
@@ -70,7 +70,7 @@
     "@vueuse/core": "^14.2.1",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
-    "h3": "^1.15.4",
+    "motion-v": "^2.3.0",
     "nitropack": "^2.13.4",
     "nuxt-og-image": "^6.7.2",
     "reka-ui": "^2.9.2",
@@ -82,10 +82,13 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@lupinum/ginko-content": ">=0.3.0-rc.2 <0.4.0",
-    "nuxt": "^4.4.6",
+    "@lupinum/ginko-content": ">=0.3.2 <0.4.0",
+    "nuxt": ">=4.4.7 <5",
     "vue": "^3.5.35",
     "vue-router": "^5.1.0"
   },
+  "engines": {
+    "node": "^22.18.0 || ^24.11.0 || >=26.0.0"
+  },
   "scripts": {}
 }

package/runtime/server/agent-markdown.ts

@@ -8,8 +8,6 @@ import { contentComponentTags } from "../../tags";
 const renderXmlComponent: AgentMarkdownSerializer = (node, ctx) =>
   ctx.xmlComponent(node.tag || "component", ctx.cleanProps(node), ctx.renderChildren(node));
 
-export const contentComponentAgentMarkdownTags = Object.keys(contentComponentTags);
-
 export function registerContentComponentAgentMarkdownSerializers() {
   const serializers: AgentMarkdownSerializerMap = {};
   for (const [tag, component] of Object.entries(contentComponentTags)) {

package/shared/theme-palettes.ts

@@ -0,0 +1,37 @@
+export const GINKO_DOCS_NEUTRAL_PALETTES = [
+  "slate",
+  "gray",
+  "zinc",
+  "neutral",
+  "stone",
+  "taupe",
+  "mauve",
+  "mist",
+  "olive",
+  "custom",
+] as const;
+
+export const GINKO_DOCS_PRIMARY_PALETTES = [
+  "neutral",
+  "red",
+  "orange",
+  "amber",
+  "yellow",
+  "lime",
+  "green",
+  "emerald",
+  "teal",
+  "cyan",
+  "sky",
+  "blue",
+  "indigo",
+  "violet",
+  "purple",
+  "fuchsia",
+  "pink",
+  "rose",
+  "custom",
+] as const;
+
+export type GinkoDocsNeutralPalette = (typeof GINKO_DOCS_NEUTRAL_PALETTES)[number];
+export type GinkoDocsPrimaryPalette = (typeof GINKO_DOCS_PRIMARY_PALETTES)[number];

package/shared/types/app-config.ts

@@ -1,13 +1,53 @@
-export type GinkoDocsLocalizedText = { en: string; de?: string };
+export type { GinkoDocsNeutralPalette, GinkoDocsPrimaryPalette } from "../theme-palettes";
+import type { GinkoDocsNeutralPalette, GinkoDocsPrimaryPalette } from "../theme-palettes";
+
+export type GinkoDocsLocalizedText = string | { en: string; de?: string };
+
+export type GinkoDocsProseAppearance = "quiet" | "tint";
+export type GinkoDocsProseFamily =
+  | "callout"
+  | "aside"
+  | "excerpt"
+  | "cards"
+  | "readMore"
+  | "accordion"
+  | "tabs"
+  | "code"
+  | "files"
+  | "api"
+  | "figure"
+  | "quiz"
+  | "steps"
+  | "timeline";
+
+export interface GinkoDocsProseConfig {
+  appearance: GinkoDocsProseAppearance;
+  components?: Partial<Record<GinkoDocsProseFamily, GinkoDocsProseAppearance>>;
+}
 
 export interface GinkoDocsLink {
   label: GinkoDocsLocalizedText;
   to: GinkoDocsLocalizedText;
+  /** Iconify icon shown where nav items render with icons (e.g. mobile menu). */
+  icon?: string;
+  /** One-line subtitle shown under the label in the mobile menu. */
+  description?: GinkoDocsLocalizedText;
+}
+
+export interface GinkoDocsHeroCodeTab {
+  label: GinkoDocsLocalizedText;
+  /** Iconify icon shown in the tab. */
+  icon?: string;
+  filename?: string;
+  /** Shiki language id; derived from the filename extension when unset. */
+  language?: string;
+  code: string;
 }
 
 export type GinkoDocsHeroMedia =
   | { type: "image"; src: string; alt: string }
-  | { type: "code"; code: string; language?: string; filename?: string };
+  | { type: "code"; code: string; language?: string; filename?: string }
+  | { type: "code-tabs"; tabs: GinkoDocsHeroCodeTab[] };
 
 export type GinkoDocsPlausibleExtension =
   | "hash"
@@ -21,12 +61,16 @@ export type GinkoDocsPlausibleExtension =
   | "manual";
 
 export interface GinkoDocsAppConfig {
+  theme: {
+    neutral: GinkoDocsNeutralPalette;
+    primary: GinkoDocsPrimaryPalette;
+  };
+  prose: GinkoDocsProseConfig;
   site: {
     name: GinkoDocsLocalizedText;
     description: GinkoDocsLocalizedText;
     url: string;
     logo: { light: string; dark: string };
-    localeSwitcher: "dropdown" | "segmented";
     docsSidebarSwitcher: "dropdown" | "list" | "tabs";
     lupinumAttribution: boolean;
   };
@@ -35,8 +79,7 @@ export interface GinkoDocsAppConfig {
     links: "auto" | GinkoDocsLink[];
   };
   banner: {
-    /** "auto" shows the banner when blog routes exist (legacy behavior). */
-    enabled: boolean | "auto";
+    enabled: boolean;
     /** Dismissal storage key — change it to re-show the banner after an update. */
     id: string;
     text?: GinkoDocsLocalizedText;
@@ -83,7 +126,6 @@ export interface GinkoDocsAppConfig {
     contentDirectory?: string;
   };
   landing: {
-    eyebrow?: GinkoDocsLocalizedText;
     title: GinkoDocsLocalizedText;
     description: GinkoDocsLocalizedText;
     primary: GinkoDocsLink;
@@ -91,10 +133,25 @@ export interface GinkoDocsAppConfig {
     hero?: {
       media?: GinkoDocsHeroMedia;
     };
+    /** Copyable install command shown under the hero CTAs. */
+    install?: { command: string };
     features: Array<{
       title: GinkoDocsLocalizedText;
       description: GinkoDocsLocalizedText;
       icon?: string;
     }>;
+    /** Dark full-width band highlighting agent readiness. */
+    agent?: {
+      title: GinkoDocsLocalizedText;
+      description: GinkoDocsLocalizedText;
+      /** Terminal transcript; "$"-prefixed lines render as commands, "#" as comments. */
+      code: string;
+    };
+    /** Closing call to action; primary falls back to landing.primary. */
+    cta?: {
+      title: GinkoDocsLocalizedText;
+      primary?: GinkoDocsLink;
+      secondary?: GinkoDocsLink;
+    };
   };
 }

package/tags.ts

@@ -3,42 +3,36 @@ import type { PortableComponentPolicyV1 } from "@lupinum/ginko-content/cms-contr
 export const contentComponentTags = {
   accordion: "MdcAccordion",
   "accordion-item": "MdcAccordionItem",
-  alert: "MdcAlert",
+  api: "MdcApi",
   aside: "MdcAside",
-  callout: "MdcCallout",
   card: "MdcCard",
-  "card-group": "MdcCardGroup",
+  cards: "MdcCards",
   center: "MdcCenter",
   "code-group": "MdcCodeGroup",
+  "code-tree": "MdcCodeTree",
+  collapse: "MdcCollapse",
   column: "MdcColumn",
-  danger: "MdcError",
-  "doc-img": "MdcDocImg",
   dropcap: "MdcDropcap",
   error: "MdcError",
-  field: "MdcField",
-  "field-group": "MdcFieldGroup",
+  excerpt: "MdcExcerpt",
   figure: "MdcFigure",
+  files: "MdcFiles",
   idea: "MdcIdea",
   img: "ProseImg",
   info: "MdcInfo",
-  kbd: "MdcShortcut",
+  kbd: "MdcKbd",
   layout: "MdcLayout",
   note: "MdcNote",
-  passage: "MdcPassage",
   quiz: "MdcQuiz",
-  "quiz-option": "MdcQuizOption",
   "quiz-question": "MdcQuizQuestion",
   "read-more": "MdcReadMore",
-  "read-more-group": "MdcReadMoreGroup",
-  shortcut: "MdcShortcut",
-  step: "MdcStep",
   steps: "MdcSteps",
   success: "MdcSuccess",
   tab: "MdcTab",
   tabs: "MdcTabs",
   timeline: "MdcTimeline",
   "timeline-item": "MdcTimelineItem",
-  warn: "MdcWarning",
+  toc: "MdcInlineToc",
   warning: "MdcWarning",
 } as const;
 
@@ -59,12 +53,13 @@ const inline = (props: ComponentProps = {}): ComponentDefinition => ({
   media: null,
 });
 
-const notice = block({ title: optional("string"), icon: optional("string") });
-const shortcut = inline({ value: optional("string"), size: optional("string") });
+const appearance = { appearance: optional("string") };
+const notice = block({ title: optional("string"), icon: optional("string"), ...appearance });
 
 export const contentComponentPolicy = {
   components: {
     accordion: block({
+      ...appearance,
       type: optional("string"),
       collapsible: optional("boolean"),
       defaultValue: optional("json"),
@@ -77,17 +72,15 @@ export const contentComponentPolicy = {
       },
       ["default", "title", "content"],
     ),
-    alert: block({
+    api: block({
+      ...appearance,
       title: optional("string"),
       icon: optional("string"),
-      type: optional("string"),
-    }),
-    aside: block({ label: optional("string") }),
-    callout: block({
-      title: optional("string"),
-      type: optional("string"),
-      icon: optional("string"),
+      method: optional("string"),
+      path: optional("string"),
+      groups: optional("json"),
     }),
+    aside: block({ label: optional("string"), ...appearance }),
     card: block(
       {
         title: optional("string"),
@@ -100,32 +93,31 @@ export const contentComponentPolicy = {
         img: optional("asset"),
         showLinkIcon: optional("boolean"),
         horizontal: optional("boolean"),
+        ...appearance,
       },
       ["default", "title", "description", "footer"],
       { sourceProp: "img", altProp: null, titleProp: null, filenameProp: null },
     ),
-    "card-group": block({ cols: optional("string") }),
+    cards: block({ cols: optional("string"), ...appearance }),
     center: block({
       size: optional("string"),
       max: optional("string"),
       type: optional("string"),
     }),
-    "code-group": block(),
+    "code-group": block(appearance),
+    "code-tree": block({
+      ...appearance,
+      defaultValue: optional("string"),
+      expandAll: optional("boolean"),
+    }),
+    collapse: block(appearance),
     column: block({ size: optional("string") }),
-    danger: notice,
-    "doc-img": block({ bleed: optional("string") }),
     dropcap: block({ lines: optional("json") }),
     error: notice,
-    field: block({
-      name: required("string"),
-      type: optional("string"),
-      required: optional("boolean"),
-      description: optional("string"),
-      defaultValue: optional("string"),
-    }),
-    "field-group": block(),
+    excerpt: block({ label: optional("string"), source: optional("string"), ...appearance }),
     figure: block(
       {
+        ...appearance,
         src: required("asset"),
         alt: required("string"),
         caption: optional("string"),
@@ -134,17 +126,19 @@ export const contentComponentPolicy = {
         bleed: optional("string"),
         aspect: optional("string"),
         fit: optional("string"),
+        zoom: optional("json"),
       },
       ["default"],
       { sourceProp: "src", altProp: "alt", titleProp: null, filenameProp: null },
     ),
+    files: block({ active: optional("string"), annotations: optional("json"), ...appearance }),
     idea: notice,
     info: notice,
-    kbd: shortcut,
+    kbd: inline(),
     layout: block({ type: optional("string") }),
     note: notice,
-    passage: block({ label: optional("string") }),
     quiz: block({
+      ...appearance,
       title: optional("string"),
       description: optional("string"),
       questionLabel: optional("string"),
@@ -156,44 +150,38 @@ export const contentComponentPolicy = {
       retryPrompt: optional("string"),
       resetLabel: optional("string"),
     }),
-    "quiz-option": block({
-      correct: optional("boolean"),
-      label: optional("string"),
-    }),
     "quiz-question": block({
       question: required("string"),
       type: optional("string"),
       explanation: optional("string"),
-      options: optional("json"),
+      options: required("json"),
       checkLabel: optional("string"),
       correctLabel: optional("string"),
       incorrectLabel: optional("string"),
       resetLabel: optional("string"),
       multipleChoiceLabel: optional("string"),
     }),
-    "read-more": block(
-      {
-        title: optional("string"),
-        to: required("string"),
-        target: optional("string"),
-        icon: optional("string"),
-      },
-      [],
-    ),
-    "read-more-group": block(),
-    shortcut,
-    step: block({ title: optional("string"), icon: optional("string") }),
-    steps: block({ variant: optional("string") }),
+    "read-more": block({ title: optional("string"), links: required("json"), ...appearance }, []),
+    steps: block({ mode: optional("string"), ...appearance }),
     success: notice,
     tab: block({ icon: optional("string"), label: optional("string") }),
-    tabs: block({ variant: optional("string"), padded: optional("boolean") }),
-    timeline: block(),
+    tabs: block({ layout: optional("string"), padded: optional("boolean"), ...appearance }),
+    timeline: block(appearance),
     "timeline-item": block({
       date: optional("string"),
       label: optional("string"),
       title: optional("string"),
+      icon: optional("string"),
+      active: optional("boolean"),
     }),
-    warn: notice,
+    toc: block(
+      {
+        title: optional("string"),
+        depth: optional("json"),
+        open: optional("json"),
+      },
+      [],
+    ),
     warning: notice,
   },
 } satisfies PortableComponentPolicyV1;

package/app/components/mdc/MdcAlert.vue

@@ -1,34 +0,0 @@
-<script setup lang="ts">
-import type { HTMLAttributes } from "vue";
-import { computed } from "vue";
-import MdcCallout from "./MdcCallout.vue";
-
-type AlertType = "default" | "info" | "warning" | "success" | "danger" | "secondary";
-type CalloutType = "info" | "warning" | "error" | "success" | "idea";
-
-const props = withDefaults(
-  defineProps<{
-    title?: string;
-    icon?: string;
-    type?: AlertType;
-    class?: HTMLAttributes["class"];
-  }>(),
-  {
-    type: "warning",
-  },
-);
-
-const calloutType = computed<CalloutType>(() => {
-  if (props.type === "danger") return "error";
-  if (props.type === "success") return "success";
-  if (props.type === "info" || props.type === "secondary") return "info";
-
-  return "warning";
-});
-</script>
-
-<template>
-  <MdcCallout :title="title" :icon="icon" :type="calloutType" :class="props.class">
-    <slot />
-  </MdcCallout>
-</template>

package/app/components/mdc/MdcCardGroup.vue

@@ -1,47 +0,0 @@
-<script setup lang="ts">
-import { computed, provide, type HTMLAttributes } from "vue";
-import { cn } from "../../utils";
-
-const props = withDefaults(
-  defineProps<{
-    cols?: 1 | 2 | 3 | 4 | 5 | 6 | "1" | "2" | "3" | "4" | "5" | "6";
-    class?: HTMLAttributes["class"];
-  }>(),
-  {
-    cols: 2,
-  },
-);
-
-provide("contentCardInGroup", true);
-
-const colsClass = {
-  1: "sm:grid-cols-1",
-  2: "sm:grid-cols-2",
-  3: "sm:grid-cols-3",
-  4: "sm:grid-cols-4",
-  5: "sm:grid-cols-5",
-  6: "sm:grid-cols-6",
-} as const;
-
-const normalizedCols = computed<keyof typeof colsClass>(() => {
-  const cols = Number(props.cols);
-
-  return cols === 1 || cols === 2 || cols === 3 || cols === 4 || cols === 5 || cols === 6
-    ? cols
-    : 2;
-});
-</script>
-
-<template>
-  <div
-    :class="
-      cn(
-        'content-card-group not-prose my-4 grid grid-cols-1 items-start gap-2',
-        colsClass[normalizedCols],
-        props.class,
-      )
-    "
-  >
-    <slot />
-  </div>
-</template>