@windrun-huaiin/third-ui 27.0.0 → 28.0.0

package/src/fuma/base/site-docs-layout.tsx

@@ -0,0 +1,35 @@
+import type { ReactNode } from 'react';
+import { DocsLayout, type DocsLayoutProps } from 'fumadocs-ui/layouts/docs';
+import {
+  normalizeNavItems,
+  type SiteBaseLayoutConfig,
+} from './site-layout-shared';
+
+export interface SiteDocsLayoutConfig extends SiteBaseLayoutConfig {
+  tree: DocsLayoutProps['tree'];
+  sidebar?: DocsLayoutProps['sidebar'];
+}
+
+function toDocsLayoutOptions(config: SiteDocsLayoutConfig): DocsLayoutProps {
+  return {
+    ...(config.nav ? { nav: config.nav } : {}),
+    ...(config.i18n ? { i18n: config.i18n } : {}),
+    ...(config.githubUrl ? { githubUrl: config.githubUrl } : {}),
+    ...(config.links ? { links: normalizeNavItems(config.links) } : {}),
+    ...(config.searchToggle ? { searchToggle: config.searchToggle } : {}),
+    ...(config.themeSwitch ? { themeSwitch: config.themeSwitch } : {}),
+    ...(config.sidebar ? { sidebar: config.sidebar } : {}),
+    tree: config.tree,
+  };
+}
+
+export function SiteDocsLayout({
+  config,
+  children,
+}: {
+  config: SiteDocsLayoutConfig;
+  children: ReactNode;
+}) {
+  const options = toDocsLayoutOptions(config);
+  return <DocsLayout {...options}>{children}</DocsLayout>;
+}

package/src/fuma/base/site-home-layout.tsx

@@ -0,0 +1,78 @@
+import type { ReactNode } from 'react';
+import {
+  CustomHomeLayout,
+  type CustomHomeLayoutProps,
+  type HeaderActionOrders,
+} from './custom-home-layout';
+import {
+  toHomeLayoutOptions,
+  type SiteBaseLayoutConfig,
+} from './site-layout-shared';
+
+export interface SiteHomeLayoutConfig extends SiteBaseLayoutConfig {
+  showBanner?: boolean;
+  bannerHeight?: number;
+  headerHeight?: number;
+  headerPaddingTop?: number;
+  navbarClassName?: string;
+  floatingNav?: boolean;
+  banner?: ReactNode;
+  footer?: ReactNode;
+  goToTop?: ReactNode;
+  showFooter?: boolean;
+  showGoToTop?: boolean;
+  actionOrders?: HeaderActionOrders;
+  localePrefixAsNeeded?: boolean;
+  defaultLocale?: string;
+}
+
+export function SiteHomeLayout({
+  locale,
+  config,
+  children,
+}: {
+  locale: string;
+  config: SiteHomeLayoutConfig;
+  children: ReactNode;
+}) {
+  const {
+    actionOrders,
+    banner,
+    bannerHeight,
+    defaultLocale,
+    floatingNav,
+    footer,
+    goToTop,
+    headerHeight,
+    headerPaddingTop,
+    localePrefixAsNeeded,
+    navbarClassName,
+    showBanner,
+    showFooter,
+    showGoToTop,
+    ...baseConfig
+  } = config;
+
+  const options = toHomeLayoutOptions(baseConfig);
+
+  const layoutProps: CustomHomeLayoutProps = {
+    locale,
+    options,
+    ...(actionOrders ? { actionOrders } : {}),
+    ...(banner ? { banner } : {}),
+    ...(bannerHeight != null ? { bannerHeight } : {}),
+    ...(defaultLocale ? { defaultLocale } : {}),
+    ...(floatingNav != null ? { floatingNav } : {}),
+    ...(footer ? { footer } : {}),
+    ...(goToTop ? { goToTop } : {}),
+    ...(headerHeight != null ? { headerHeight } : {}),
+    ...(headerPaddingTop != null ? { headerPaddingTop } : {}),
+    ...(localePrefixAsNeeded != null ? { localePrefixAsNeeded } : {}),
+    ...(navbarClassName ? { navbarClassName } : {}),
+    ...(showBanner != null ? { showBanner } : {}),
+    ...(showFooter != null ? { showFooter } : {}),
+    ...(showGoToTop != null ? { showGoToTop } : {}),
+  };
+
+  return <CustomHomeLayout {...layoutProps}>{children}</CustomHomeLayout>;
+}

package/src/fuma/base/site-layout-shared.tsx

@@ -0,0 +1,190 @@
+import type { HTMLAttributes, ReactNode } from 'react';
+import type { HomeLayoutProps } from 'fumadocs-ui/layouts/home';
+import type { LinkItemType } from 'fumadocs-ui/layouts/shared';
+
+export type ExtendedLinkItem = LinkItemType & {
+  mobilePinned?: boolean;
+  prefetch?: boolean;
+};
+
+type SiteMenuConfig = HTMLAttributes<HTMLElement> & {
+  banner?: ReactNode;
+};
+
+interface SiteNavSharedFields {
+  secondary?: boolean;
+  mobilePinned?: boolean;
+}
+
+export interface SiteNavLinkItemConfig extends SiteNavSharedFields {
+  type?: 'main' | 'icon' | 'button';
+  text: ReactNode;
+  url: string;
+  external?: boolean;
+  prefetch?: boolean;
+  icon?: ReactNode;
+  description?: ReactNode;
+  menu?: SiteMenuConfig;
+  on?: 'nav' | 'menu' | 'all';
+  label?: string;
+}
+
+export interface SiteNavMenuItemConfig extends SiteNavSharedFields {
+  type: 'menu';
+  text: ReactNode;
+  url?: string;
+  external?: boolean;
+  prefetch?: boolean;
+  icon?: ReactNode;
+  description?: ReactNode;
+  items: SiteNavItemConfig[];
+  menu?: SiteMenuConfig;
+  on?: 'nav' | 'menu' | 'all';
+}
+
+export interface SiteNavCustomItemConfig extends SiteNavSharedFields {
+  type: 'custom';
+  children: ReactNode;
+}
+
+export type SiteNavItemConfig =
+  | SiteNavLinkItemConfig
+  | SiteNavMenuItemConfig
+  | SiteNavCustomItemConfig;
+
+export interface SiteBaseLayoutConfig {
+  nav?: HomeLayoutProps['nav'];
+  i18n?: HomeLayoutProps['i18n'];
+  githubUrl?: string;
+  links?: SiteNavItemConfig[];
+  searchToggle?: HomeLayoutProps['searchToggle'];
+  themeSwitch?: HomeLayoutProps['themeSwitch'];
+}
+
+export interface SiteMenuLeafConfig {
+  text: ReactNode;
+  path: string;
+  description?: ReactNode;
+  icon?: ReactNode;
+  className?: string;
+  external?: boolean;
+  prefetch?: boolean;
+}
+
+export interface SiteMenuGroupConfig {
+  text: ReactNode;
+  path?: string;
+  prefetch?: boolean;
+  landing?: SiteMenuLeafConfig;
+  items: SiteMenuLeafConfig[];
+}
+
+export interface CreateSiteNavItemContext {
+  resolveUrl: (path: string) => string;
+}
+
+export interface CreateSiteNavGroupOptions {
+  featuredClassName?: string;
+  featuredBanner?: ReactNode;
+}
+
+export interface CreateSiteBaseLayoutOptions {
+  homeUrl: string;
+  title: ReactNode;
+  i18n?: HomeLayoutProps['i18n'];
+  githubUrl?: string;
+  transparentMode?: HomeLayoutProps['nav'] extends infer T
+    ? T extends { transparentMode?: infer U }
+      ? U
+      : never
+    : never;
+}
+
+export function normalizeNavItems(items?: SiteNavItemConfig[]): ExtendedLinkItem[] | undefined {
+  if (!items) return undefined;
+
+  return items.map((item) => {
+    if (item.type === 'menu') {
+      return {
+        ...item,
+        items: normalizeNavItems(item.items) ?? [],
+      } as ExtendedLinkItem;
+    }
+
+    return item as ExtendedLinkItem;
+  });
+}
+
+export function createSiteNavLink(
+  item: SiteMenuLeafConfig,
+  context: CreateSiteNavItemContext,
+): SiteNavLinkItemConfig {
+  return {
+    type: 'main',
+    text: item.text,
+    ...(item.description ? { description: item.description } : {}),
+    url: context.resolveUrl(item.path),
+    ...(item.external ? { external: item.external } : {}),
+    ...(item.prefetch !== undefined ? { prefetch: item.prefetch } : {}),
+    ...(item.icon || item.className
+      ? {
+          menu: {
+            ...(item.icon ? { banner: item.icon } : {}),
+            ...(item.className ? { className: item.className } : {}),
+          },
+        }
+      : {}),
+  };
+}
+
+export function createSiteNavGroup(
+  item: SiteMenuGroupConfig,
+  context: CreateSiteNavItemContext,
+  options?: CreateSiteNavGroupOptions,
+): SiteNavMenuItemConfig {
+  return {
+    type: 'menu',
+    text: item.text,
+    ...(item.path ? { url: context.resolveUrl(item.path) } : {}),
+    ...(item.prefetch !== undefined ? { prefetch: item.prefetch } : {}),
+    items: [
+      ...(item.landing
+        ? [
+            {
+              ...createSiteNavLink(item.landing, context),
+              menu: {
+                ...(options?.featuredBanner ? { banner: options.featuredBanner } : {}),
+                className: options?.featuredClassName ?? 'md:row-span-2',
+              },
+            } satisfies SiteNavLinkItemConfig,
+          ]
+        : []),
+      ...item.items.map((child) => createSiteNavLink(child, context)),
+    ],
+  };
+}
+
+export function createSiteBaseLayoutConfig(
+  options: CreateSiteBaseLayoutOptions,
+): SiteBaseLayoutConfig {
+  return {
+    nav: {
+      url: options.homeUrl,
+      title: options.title,
+      transparentMode: options.transparentMode ?? 'none',
+    },
+    ...(options.i18n ? { i18n: options.i18n } : {}),
+    ...(options.githubUrl ? { githubUrl: options.githubUrl } : {}),
+  };
+}
+
+export function toHomeLayoutOptions(config: SiteBaseLayoutConfig): HomeLayoutProps {
+  return {
+    ...(config.nav ? { nav: config.nav } : {}),
+    ...(config.i18n ? { i18n: config.i18n } : {}),
+    ...(config.githubUrl ? { githubUrl: config.githubUrl } : {}),
+    ...(config.links ? { links: normalizeNavItems(config.links) } : {}),
+    ...(config.searchToggle ? { searchToggle: config.searchToggle } : {}),
+    ...(config.themeSwitch ? { themeSwitch: config.themeSwitch } : {}),
+  };
+}

package/src/fuma/base/site-layout.tsx

@@ -1,295 +1,4 @@
-import { type ComponentProps, type HTMLAttributes, type ReactNode } from 'react';
-import { RootProvider } from 'fumadocs-ui/provider/next';
-import { DocsLayout, type DocsLayoutProps } from 'fumadocs-ui/layouts/docs';
-import { type HomeLayoutProps } from 'fumadocs-ui/layouts/home';
-import { CustomHomeLayout, type CustomHomeLayoutProps, type ExtendedLinkItem, type HeaderActionOrders } from './custom-home-layout';
-
-type RootProviderI18n = NonNullable<ComponentProps<typeof RootProvider>['i18n']>;
-
-export interface DocsRootProviderProps {
-  i18n: RootProviderI18n;
-  children: ReactNode;
-}
-
-type SiteMenuConfig = HTMLAttributes<HTMLElement> & {
-  banner?: ReactNode;
-};
-
-interface SiteNavSharedFields {
-  secondary?: boolean;
-  mobilePinned?: boolean;
-}
-
-export interface SiteNavLinkItemConfig extends SiteNavSharedFields {
-  type?: 'main' | 'icon' | 'button';
-  text: ReactNode;
-  url: string;
-  external?: boolean;
-  prefetch?: boolean;
-  icon?: ReactNode;
-  description?: ReactNode;
-  menu?: SiteMenuConfig;
-  on?: 'nav' | 'menu' | 'all';
-  label?: string;
-}
-
-export interface SiteNavMenuItemConfig extends SiteNavSharedFields {
-  type: 'menu';
-  text: ReactNode;
-  url?: string;
-  external?: boolean;
-  prefetch?: boolean;
-  icon?: ReactNode;
-  description?: ReactNode;
-  items: SiteNavItemConfig[];
-  menu?: SiteMenuConfig;
-  on?: 'nav' | 'menu' | 'all';
-}
-
-export interface SiteNavCustomItemConfig extends SiteNavSharedFields {
-  type: 'custom';
-  children: ReactNode;
-}
-
-export type SiteNavItemConfig =
-  | SiteNavLinkItemConfig
-  | SiteNavMenuItemConfig
-  | SiteNavCustomItemConfig;
-
-export interface SiteBaseLayoutConfig {
-  nav?: HomeLayoutProps['nav'];
-  i18n?: HomeLayoutProps['i18n'];
-  githubUrl?: string;
-  links?: SiteNavItemConfig[];
-  searchToggle?: HomeLayoutProps['searchToggle'];
-  themeSwitch?: HomeLayoutProps['themeSwitch'];
-}
-
-export interface SiteHomeLayoutConfig extends SiteBaseLayoutConfig {
-  showBanner?: boolean;
-  bannerHeight?: number;
-  headerHeight?: number;
-  headerPaddingTop?: number;
-  navbarClassName?: string;
-  floatingNav?: boolean;
-  banner?: ReactNode;
-  footer?: ReactNode;
-  goToTop?: ReactNode;
-  showFooter?: boolean;
-  showGoToTop?: boolean;
-  actionOrders?: HeaderActionOrders;
-  localePrefixAsNeeded?: boolean;
-  defaultLocale?: string;
-}
-
-export interface SiteDocsLayoutConfig extends SiteBaseLayoutConfig {
-  tree: DocsLayoutProps['tree'];
-  sidebar?: DocsLayoutProps['sidebar'];
-}
-
-export interface SiteMenuLeafConfig {
-  text: ReactNode;
-  path: string;
-  description?: ReactNode;
-  icon?: ReactNode;
-  className?: string;
-  external?: boolean;
-  prefetch?: boolean;
-}
-
-export interface SiteMenuGroupConfig {
-  text: ReactNode;
-  path?: string;
-  prefetch?: boolean;
-  landing?: SiteMenuLeafConfig;
-  items: SiteMenuLeafConfig[];
-}
-
-export interface CreateSiteNavItemContext {
-  resolveUrl: (path: string) => string;
-}
-
-export interface CreateSiteNavGroupOptions {
-  featuredClassName?: string;
-  featuredBanner?: ReactNode;
-}
-
-export interface CreateSiteBaseLayoutOptions {
-  homeUrl: string;
-  title: ReactNode;
-  i18n?: HomeLayoutProps['i18n'];
-  githubUrl?: string;
-  transparentMode?: HomeLayoutProps['nav'] extends infer T
-    ? T extends { transparentMode?: infer U }
-      ? U
-      : never
-    : never;
-}
-
-function normalizeNavItems(items?: SiteNavItemConfig[]): ExtendedLinkItem[] | undefined {
-  if (!items) return undefined;
-
-  return items.map((item) => {
-    if (item.type === 'menu') {
-      return {
-        ...item,
-        items: normalizeNavItems(item.items) ?? [],
-      } as ExtendedLinkItem;
-    }
-
-    return item as ExtendedLinkItem;
-  });
-}
-
-export function createSiteNavLink(
-  item: SiteMenuLeafConfig,
-  context: CreateSiteNavItemContext,
-): SiteNavLinkItemConfig {
-  return {
-    type: 'main',
-    text: item.text,
-    ...(item.description ? { description: item.description } : {}),
-    url: context.resolveUrl(item.path),
-    ...(item.external ? { external: item.external } : {}),
-    ...(item.prefetch !== undefined ? { prefetch: item.prefetch } : {}),
-    ...(item.icon || item.className
-      ? {
-          menu: {
-            ...(item.icon ? { banner: item.icon } : {}),
-            ...(item.className ? { className: item.className } : {}),
-          },
-        }
-      : {}),
-  };
-}
-
-export function createSiteNavGroup(
-  item: SiteMenuGroupConfig,
-  context: CreateSiteNavItemContext,
-  options?: CreateSiteNavGroupOptions,
-): SiteNavMenuItemConfig {
-  return {
-    type: 'menu',
-    text: item.text,
-    ...(item.path ? { url: context.resolveUrl(item.path) } : {}),
-    ...(item.prefetch !== undefined ? { prefetch: item.prefetch } : {}),
-    items: [
-      ...(item.landing
-        ? [
-            {
-              ...createSiteNavLink(item.landing, context),
-              menu: {
-                ...(options?.featuredBanner ? { banner: options.featuredBanner } : {}),
-                className: options?.featuredClassName ?? 'md:row-span-2',
-              },
-            } satisfies SiteNavLinkItemConfig,
-          ]
-        : []),
-      ...item.items.map((child) => createSiteNavLink(child, context)),
-    ],
-  };
-}
-
-export function createSiteBaseLayoutConfig(
-  options: CreateSiteBaseLayoutOptions,
-): SiteBaseLayoutConfig {
-  return {
-    nav: {
-      url: options.homeUrl,
-      title: options.title,
-      transparentMode: options.transparentMode ?? 'none',
-    },
-    ...(options.i18n ? { i18n: options.i18n } : {}),
-    ...(options.githubUrl ? { githubUrl: options.githubUrl } : {}),
-  };
-}
-
-function toHomeLayoutOptions(config: SiteBaseLayoutConfig): HomeLayoutProps {
-  return {
-    ...(config.nav ? { nav: config.nav } : {}),
-    ...(config.i18n ? { i18n: config.i18n } : {}),
-    ...(config.githubUrl ? { githubUrl: config.githubUrl } : {}),
-    ...(config.links ? { links: normalizeNavItems(config.links) } : {}),
-    ...(config.searchToggle ? { searchToggle: config.searchToggle } : {}),
-    ...(config.themeSwitch ? { themeSwitch: config.themeSwitch } : {}),
-  };
-}
-
-function toDocsLayoutOptions(config: SiteDocsLayoutConfig): DocsLayoutProps {
-  return {
-    ...(config.nav ? { nav: config.nav } : {}),
-    ...(config.i18n ? { i18n: config.i18n } : {}),
-    ...(config.githubUrl ? { githubUrl: config.githubUrl } : {}),
-    ...(config.links ? { links: normalizeNavItems(config.links) } : {}),
-    ...(config.searchToggle ? { searchToggle: config.searchToggle } : {}),
-    ...(config.themeSwitch ? { themeSwitch: config.themeSwitch } : {}),
-    ...(config.sidebar ? { sidebar: config.sidebar } : {}),
-    tree: config.tree,
-  };
-}
-
-export function DocsRootProvider({ i18n, children }: DocsRootProviderProps) {
-  return <RootProvider i18n={i18n}>{children}</RootProvider>;
-}
-
-export function SiteHomeLayout({
-  locale,
-  config,
-  children,
-}: {
-  locale: string;
-  config: SiteHomeLayoutConfig;
-  children: ReactNode;
-}) {
-  const {
-    actionOrders,
-    banner,
-    bannerHeight,
-    defaultLocale,
-    floatingNav,
-    footer,
-    goToTop,
-    headerHeight,
-    headerPaddingTop,
-    localePrefixAsNeeded,
-    navbarClassName,
-    showBanner,
-    showFooter,
-    showGoToTop,
-    ...baseConfig
-  } = config;
-
-  const options = toHomeLayoutOptions(baseConfig);
-
-  const layoutProps: CustomHomeLayoutProps = {
-    locale,
-    options,
-    ...(actionOrders ? { actionOrders } : {}),
-    ...(banner ? { banner } : {}),
-    ...(bannerHeight != null ? { bannerHeight } : {}),
-    ...(defaultLocale ? { defaultLocale } : {}),
-    ...(floatingNav != null ? { floatingNav } : {}),
-    ...(footer ? { footer } : {}),
-    ...(goToTop ? { goToTop } : {}),
-    ...(headerHeight != null ? { headerHeight } : {}),
-    ...(headerPaddingTop != null ? { headerPaddingTop } : {}),
-    ...(localePrefixAsNeeded != null ? { localePrefixAsNeeded } : {}),
-    ...(navbarClassName ? { navbarClassName } : {}),
-    ...(showBanner != null ? { showBanner } : {}),
-    ...(showFooter != null ? { showFooter } : {}),
-    ...(showGoToTop != null ? { showGoToTop } : {}),
-  };
-
-  return <CustomHomeLayout {...layoutProps}>{children}</CustomHomeLayout>;
-}
-
-export function SiteDocsLayout({
-  config,
-  children,
-}: {
-  config: SiteDocsLayoutConfig;
-  children: ReactNode;
-}) {
-  const options = toDocsLayoutOptions(config);
-  return <DocsLayout {...options}>{children}</DocsLayout>;
-}
+export * from './docs-root-provider';
+export * from './site-docs-layout';
+export * from './site-home-layout';
+export * from './site-layout-shared';

package/src/fuma/fuma-page-genarator.tsx

@@ -2,7 +2,7 @@ import { DocsBody, DocsDescription, DocsPage, DocsTitle } from 'fumadocs-ui/page
 import { ReactNode, ReactElement, cloneElement, type CSSProperties } from 'react';
 import { TocFooterWrapper } from './mdx/toc-footer-wrapper';
 import type { LLMCopyButtonProps, LLMCopyButton } from './mdx/toc-base';
-import { getAsNeededLocalizedUrl } from '@windrun-huaiin/lib';
+import { getAsNeededLocalizedUrl } from '@windrun-huaiin/lib/utils';
 import { PortableClerkTOC, PortableClerkTOCTitle } from './mdx/toc-clerk-portable';
 import { themeSvgIconColor } from '@windrun-huaiin/base-ui/lib';
 

package/src/fuma/server/llm-copy-handler.ts

@@ -0,0 +1,2 @@
+export { LLMCopyHandler } from '../llm-copy-handler';
+export type { LLMCopyHandlerOptions } from '../llm-copy-handler';

package/src/fuma/server/page-generator.ts

@@ -0,0 +1,2 @@
+export { createFumaPage } from '../fuma-page-genarator';
+export type { FumaPageTocRenderMode } from '../fuma-page-genarator';

package/src/lib/seo-metadata.ts

@@ -1,6 +1,6 @@
 import type { Metadata } from 'next';
 import { getTranslations } from 'next-intl/server';
-import { getAsNeededLocalizedUrl } from '@windrun-huaiin/lib';
+import { getAsNeededLocalizedUrl } from '@windrun-huaiin/lib/utils';
 
 export interface CreateLocalizedSiteMetadataOptions {
   locale: string;

package/src/lib/seo-util.ts

@@ -1,7 +1,7 @@
 import type { MetadataRoute } from 'next';
 import fs from 'fs';
 import path from 'path';
-import { getAsNeededLocalizedUrl } from '@windrun-huaiin/lib';
+import { getAsNeededLocalizedUrl } from '@windrun-huaiin/lib/utils';
 
 /**
  * Generate robots.txt content
@@ -139,4 +139,4 @@ export function createSitemapHandler(
   (sitemapHandler as any).dynamic = 'force-static';
 
   return sitemapHandler;
-}
+}