@coffic/cosy-ui 0.7.4 → 0.8.7

package/dist/src-astro/types/heading.ts

@@ -0,0 +1,13 @@
+/**
+ * 表示文档中的标题结构
+ */
+export interface IHeadingType {
+  /** 标题深度，如 h1=1, h2=2, h3=3 等 */
+  depth: number;
+
+  /** 标题的唯一标识符，用于锚点链接 */
+  slug: string;
+
+  /** 标题文本内容 */
+  text: string;
+}

package/dist/src-astro/types/image.ts

@@ -0,0 +1,16 @@
+/**
+ * 图片元数据接口
+ * 用于统一管理项目中的图片元数据类型
+ */
+export interface ImageMetadata {
+  src: string;
+  width: number;
+  height: number;
+  format: string;
+}
+
+/**
+ * 图片源类型
+ * 可以是 ImageMetadata 对象或字符串 URL
+ */
+export type ImageSource = ImageMetadata | string;

package/dist/src-astro/types/layout.ts

@@ -0,0 +1,71 @@
+import type { IFooterProps } from './footer';
+import type { IHeaderProps } from './header';
+import type { IMainContentProps } from './main';
+import type { IMetaProps } from './meta';
+import type { ISidebarProps } from './sidebar';
+
+export interface IAppLayoutProps {
+  /**
+   * 是否显示侧边栏
+   * @default true
+   */
+  showSidebar?: boolean;
+
+  /**
+   * 是否显示页眉
+   * @default true
+   */
+  showHeader?: boolean;
+
+  /**
+   * 是否显示页脚
+   * @default true
+   */
+  showFooter?: boolean;
+
+  /**
+   * 自定义头部内容
+   */
+  head?: astroHTML.JSX.Element;
+
+  /**
+   * 自定义头部内容
+   */
+  headerConfig: IHeaderProps;
+
+  /**
+   * 侧边栏配置
+   */
+  sidebarConfig: ISidebarProps;
+
+  /**
+   * 主内容配置
+   */
+  mainContentConfig: IMainContentProps;
+
+  /**
+   * 页面类名
+   */
+  class?: string;
+
+  /**
+   * 类名列表
+   */
+  'class:list'?: any;
+
+  /**
+   * 调试模式，显示各个部分的边框
+   * @default false
+   */
+  debug?: boolean;
+
+  /**
+   * 元数据配置
+   */
+  metaConfig: IMetaProps;
+
+  /**
+   * 页脚相关配置
+   */
+  footerConfig: IFooterProps;
+}

package/dist/src-astro/types/main.ts

@@ -0,0 +1,86 @@
+export interface IMainContentProps {
+  /**
+   * 容器大小
+   * @default "md"
+   */
+  size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'full';
+
+  /**
+   * 水平内边距（通过 Container 组件的 padding 属性设置）
+   * @default "md"
+   */
+  padding?: 'none' | 'sm' | 'md' | 'lg' | 'xl';
+
+  /**
+   * 布局方式
+   * @default 'column'
+   */
+  layout?: 'row' | 'column';
+
+  /**
+   * 当前语言
+   */
+  currentLocale?: string;
+
+  /**
+   * 垂直内边距
+   * @default "md"
+   */
+  verticalPadding?:
+    | 'none'
+    | 'xs'
+    | 'sm'
+    | 'md'
+    | 'lg'
+    | 'xl'
+    | '2xl'
+    | '3xl'
+    | '4xl'
+    | '5xl'
+    | string;
+
+  /**
+   * 是否居中显示内容
+   * @default true
+   */
+  centered?: boolean;
+
+  /**
+   * 是否为文章布局
+   * @default false
+   */
+  isArticle?: boolean;
+
+  /**
+   * 是否显示目录
+   * @default false
+   */
+  showTableOfContents?: boolean;
+
+  /**
+   * 背景颜色
+   * @default undefined
+   */
+  backgroundColor?:
+    | 'primary'
+    | 'secondary'
+    | 'tertiary'
+    | 'light'
+    | 'dark'
+    | string;
+
+  /**
+   * HTML id 属性
+   */
+  id?: string;
+
+  /**
+   * 类名
+   */
+  class?: string;
+
+  /**
+   * 类名列表
+   */
+  'class:list'?: any;
+}

package/dist/src-astro/types/menu.ts

@@ -0,0 +1,24 @@
+/**
+ * 菜单项接口
+ */
+export interface IMenuItem {
+  /**
+   * 菜单项文本
+   */
+  text: string;
+
+  /**
+   * 菜单项链接
+   */
+  href: string;
+
+  /**
+   * 菜单项图标
+   */
+  icon: string;
+
+  /**
+   * 子菜单项
+   */
+  items?: IMenuItem[];
+}

package/dist/src-astro/types/meta.ts

@@ -0,0 +1,55 @@
+export interface IMetaProps {
+  title: string;
+  description: string;
+  keywords: string;
+  author: string;
+  robots: string;
+
+  /**
+   * 图标
+   */
+  favicon?: ImageMetadata;
+
+  /**
+   * 基础路径，用于处理网站部署在二级目录的情况
+   * @default ""
+   */
+  basePath?: string;
+
+  /**
+   * 站点名称
+   */
+  siteName?: string;
+
+  /**
+   * 页面语言
+   * @default "zh-CN"
+   */
+  lang?: string;
+
+  /**
+   * 是否包含视口元标签
+   * @default true
+   */
+  viewport?: boolean;
+
+  /**
+   * 自定义CSS
+   */
+  customStyles?: string;
+
+  /**
+   * 自定义头部内容
+   */
+  head?: astroHTML.JSX.Element;
+
+  /**
+   * 页面类名
+   */
+  class?: string;
+
+  /**
+   * 类名列表
+   */
+  'class:list'?: any;
+}

package/dist/src-astro/types/product.ts

@@ -0,0 +1,10 @@
+export interface ILogo {
+  src: string;
+  alt: string;
+}
+
+export interface IProduct {
+  name: string;
+  href: string;
+  external?: boolean;
+}

package/dist/src-astro/types/sidebar.ts

@@ -0,0 +1,59 @@
+/**
+ * 侧边栏项目
+ */
+export interface ISidebarItem {
+  href: string;
+  text: string;
+  items?: ISidebarItem[];
+}
+
+/**
+ * 侧边栏配置
+ */
+export interface ISidebarProps {
+  /**
+   * 侧边栏项目
+   */
+  sidebarItems: ISidebarItem[];
+
+  /**
+   * 桌面端类名
+   */
+  class?: string;
+
+  /**
+   * 是否开启调试模式，显示边框
+   * @default false
+   */
+  debug?: boolean;
+
+  /**
+   * 侧边栏顶部外边距
+   */
+  marginTop?:
+    | 'xs'
+    | 'sm'
+    | 'md'
+    | 'lg'
+    | 'xl'
+    | '2xl'
+    | '3xl'
+    | '4xl'
+    | '5xl'
+    | string;
+
+  /**
+   * 侧边栏底部外边距
+   */
+  marginBottom?:
+    | 'xs'
+    | 'sm'
+    | 'md'
+    | 'lg'
+    | 'xl'
+    | '2xl'
+    | '3xl'
+    | '4xl'
+    | '5xl'
+    | string;
+}

package/dist/src-astro/types/static-path.ts

@@ -0,0 +1,8 @@
+export interface ITagStaticPath {
+  params: {
+    slug: string;
+  };
+  props: {
+    tag: string;
+  };
+}

package/dist/src-astro/utils/component.ts

@@ -0,0 +1,42 @@
+// 提取简单示例源代码函数
+export function extractSimpleExample(source: string, name: string): string {
+  // 提取模板部分
+  const templateMatch = source.match(/<template>([\s\S]*)<\/template>/m);
+  const scriptMatch = source.match(/<script[\s\S]*?>([\s\S]*)<\/script>/m);
+
+  if (!templateMatch) {
+    return source;
+  }
+
+  let importSection = `<script setup lang="ts">
+import { ref } from 'vue'
+import { ${name} } from '@cosy/index_vue'
+`;
+
+  // 从源码中提取导入语句（除了组件的导入和app.css）
+  if (scriptMatch && scriptMatch[1]) {
+    const importLines = scriptMatch[1]
+      .split('\n')
+      .filter(
+        (line) =>
+          line.includes('import') &&
+          !line.includes('../../app.css') &&
+          !line.includes(name)
+      );
+
+    if (importLines.length > 0) {
+      importSection += importLines.join('\n') + '\n';
+    }
+  }
+
+  importSection += '</script>\n\n';
+
+  // 提取模板内容，并替换组件路径
+  const templateContent = templateMatch[1]
+    .replace(`./${name}.vue`, name)
+    .replace(`../${name}.vue`, name)
+    .replace(`./${name}.astro`, name)
+    .replace(`../${name}.astro`, name);
+
+  return importSection + '<template>' + templateContent + '</template>';
+}

package/dist/src-astro/utils/i18n.ts

@@ -0,0 +1,83 @@
+/**
+ * 国际化文本配置
+ *
+ * 提供组件的多语言文本内容
+ */
+
+// 定义文本内容的类型
+type TextContent = Record<string, Record<string, string>>;
+
+// 多语言文本内容
+export const texts: Record<string, TextContent> = {
+  en: {
+    tableOfContents: {
+      title: 'Table of Contents',
+      loading: 'Loading...',
+    },
+    footer: {
+      products: 'Products',
+      about: 'About',
+      aboutUs: 'About Us',
+      team: 'Our Team',
+      careers: 'Careers',
+      contactUs: 'Contact Us',
+      resources: 'Resources',
+      news: 'News',
+      blog: 'Blog',
+      faq: 'FAQ',
+      history: 'History',
+      techStack: 'Tech Stack',
+      legal: 'Legal',
+      terms: 'Terms of Service',
+      privacy: 'Privacy Policy',
+      slogan: 'Build a beautiful digital experience',
+      allRightsReserved: 'All Rights Reserved',
+    },
+  },
+  'zh-cn': {
+    tableOfContents: {
+      title: '目录',
+      loading: '加载中...',
+    },
+    footer: {
+      products: '产品',
+      about: '关于',
+      aboutUs: '关于我们',
+      team: '团队介绍',
+      careers: '加入我们',
+      contactUs: '联系我们',
+      defaultSlogan: '优雅、高效的组件库',
+      resources: '资源',
+      news: '新闻动态',
+      blog: '技术博客',
+      faq: '常见问题',
+      history: '发展历程',
+      techStack: '技术栈',
+      legal: '法律',
+      terms: '服务条款',
+      privacy: '隐私政策',
+      allRightsReserved: '保留所有权利',
+    },
+  },
+};
+
+/**
+ * 获取指定语言的文本内容
+ * @param lang 语言代码
+ * @param component 组件名称
+ * @param key 文本键名
+ * @returns 对应的文本内容
+ */
+export function getText(lang: string, component: string, key: string): string {
+  return texts[lang]?.[component]?.[key] || texts['en'][component]?.[key] || '';
+}
+
+/**
+ * 创建组件的文本获取函数
+ * @param langInfo 语言信息
+ * @param component 组件名称
+ * @returns 文本获取函数
+ */
+export function createTextGetter(langInfo: string, component: string) {
+  return (key: string): string => getText(langInfo, component, key);
+}

package/dist/src-astro/utils/image.ts

@@ -0,0 +1,128 @@
+/**
+ * 图片工具函数
+ * 提供多种图片服务选项，用于生成示例图片
+ */
+
+export type ImageProvider = 'picsum' | 'unsplash' | 'placeholder' | 'robohash';
+
+export interface ImageOptions {
+  width: number;
+  height: number;
+  tag?: string;
+  randomSeed?: number | string;
+  provider?: ImageProvider;
+  grayscale?: boolean;
+  blur?: number;
+}
+
+/**
+ * 获取示例图片URL
+ * @param options 图片选项配置
+ * @returns 生成的图片URL
+ *
+ * @example
+ * // 基本用法
+ * getExampleImage({ width: 400, height: 300 })
+ *
+ * @example
+ * // 使用Unsplash并添加标签
+ * getExampleImage({
+ *   width: 400,
+ *   height: 300,
+ *   provider: 'unsplash',
+ *   tag: 'nature'
+ * })
+ */
+export function getExampleImage(options: ImageOptions): string {
+  const {
+    width,
+    height,
+    provider = 'picsum',
+    tag = '',
+    randomSeed = Math.floor(Math.random() * 1000),
+    grayscale = false,
+    blur = 0,
+  } = options;
+
+  switch (provider) {
+    case 'picsum': {
+      const picsumParams = [];
+      if (grayscale) picsumParams.push('grayscale');
+      if (blur > 0 && blur <= 10) picsumParams.push(`blur=${blur}`);
+
+      const picsumQuery = picsumParams.length
+        ? `?${picsumParams.join('&')}`
+        : `?random=${randomSeed}`;
+
+      return `https://picsum.photos/${width}/${height}${picsumQuery}`;
+    }
+
+    case 'unsplash': {
+      const tagQuery = tag ? `?${tag}` : '';
+      return `https://source.unsplash.com/random/${width}x${height}${tagQuery}`;
+    }
+
+    case 'placeholder': {
+      const color = grayscale ? 'gray' : '';
+      const placeholderParams = [];
+      if (tag) placeholderParams.push(`text=${encodeURIComponent(tag)}`);
+      if (color) placeholderParams.push(`bg=${color}`);
+
+      const placeholderQuery = placeholderParams.length
+        ? `?${placeholderParams.join('&')}`
+        : '';
+
+      return `https://via.placeholder.com/${width}x${height}${placeholderQuery}`;
+    }
+
+    case 'robohash': {
+      const seed = String(tag || randomSeed);
+      return `https://robohash.org/${encodeURIComponent(seed)}?size=${width}x${height}`;
+    }
+
+    default: {
+      return `https://picsum.photos/${width}/${height}?random=${randomSeed}`;
+    }
+  }
+}
+
+/**
+ * 获取产品示例图片
+ * @param options 可选的图片选项配置
+ */
+export function getProductImage(options: Partial<ImageOptions> = {}): string {
+  return getExampleImage({
+    width: options.width || 400,
+    height: options.height || 300,
+    provider: options.provider || 'picsum',
+    tag: options.tag || 'product',
+    ...options,
+  });
+}
+
+/**
+ * 获取头像示例图片
+ * @param options 可选的图片选项配置
+ */
+export function getAvatarImage(options: Partial<ImageOptions> = {}): string {
+  return getExampleImage({
+    width: options.width || 200,
+    height: options.height || 200,
+    provider: options.provider || 'robohash',
+    ...options,
+  });
+}
+
+/**
+ * 获取景观示例图片
+ * @param options 可选的图片选项配置
+ */
+export function getLandscapeImage(options: Partial<ImageOptions> = {}): string {
+  return getExampleImage({
+    width: options.width || 800,
+    height: options.height || 400,
+    provider: options.provider || 'unsplash',
+    tag: options.tag || 'landscape',
+    ...options,
+  });
+}