@hefou/lum 0.0.0-stage → 1.0.0

package/style/picture.css

@@ -0,0 +1,40 @@
+/**
+ * Component: picture
+ * -------------------------------------------------------------------------- */
+
+:root:not(.dark) .dark-only,
+:root:is(.dark) .light-only,
+:root:not(.dark) img[src$='#dark'],
+:root:is(.dark) img[src$='#light'] {
+  display: none;
+}
+
+/* @mdit/plugin-figure: https://mdit-plugins.github.io/zh/figure.html */
+:root:not(.dark) .dark-only + figcaption,
+:root:is(.dark) .light-only + figcaption,
+:root:not(.dark) img[src$='#dark'] + figcaption,
+:root:is(.dark) img[src$='#light'] + figcaption {
+  display: none;
+}
+
+figure {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  text-align: center;
+}
+
+figure img {
+  border-radius: 0.5em;
+}
+
+figure figcaption {
+  margin: 0;
+  color: var(--vp-c-text-3);
+  font-weight: 400;
+  font-size: 0.875em;
+}
+
+figure figcaption a {
+  color: var(--vp-c-text-3) !important;
+}

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "esModuleInterop": true,
+    "jsx": "preserve",
+    "lib": ["esnext", "dom", "dom.iterable"],
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "noUnusedLocals": true,
+    "resolveJsonModule": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "target": "esnext",
+    "typeRoots": ["./types", "./node_modules/@types"],
+    "verbatimModuleSyntax": true
+  },
+  "include": ["types/**/*.d.ts", "**/*.ts", "**/*.vue"]
+}

package/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from '../components'
+export * from '../composables'
+export * from './types'

package/types/index.ts

@@ -0,0 +1,6 @@
+import '../style/components-var.css'
+import 'iconify-icon'
+
+export * from '../components'
+export * from '../composables'
+export * from './types'

package/types/shims.d.ts

@@ -0,0 +1,36 @@
+interface ImportMetaEnv {
+  readonly PROD: boolean;
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}
+
+declare module "*.css" {
+  const content: Record<string, string>;
+  export default content;
+}
+
+declare module "*.scss" {
+  const content: Record<string, string>;
+  export default content;
+}
+
+declare module "*.sass" {
+  const content: Record<string, string>;
+  export default content;
+}
+
+declare module "*.vue" {
+  import type { DefineComponent } from "vue";
+
+  const component: DefineComponent<{}, {}, any>;
+  export default component;
+}
+
+declare module "iconify-icon" {}
+
+declare module "lum/*" {
+  const content: any;
+  export default content;
+}

package/types/style.d.ts

@@ -0,0 +1,10 @@
+declare module "lum/style" {}
+declare module "lum/icon" {}
+declare module "lum/button" {}
+declare module "lum/colors" {}
+declare module "lum/doc" {}
+declare module "lum/doc-blocks" {}
+declare module "lum/home" {}
+declare module "lum/pic" {}
+declare module "lum/badge" {}
+declare module "lum/components-var" {}

package/types/types.ts

@@ -0,0 +1,318 @@
+/** 图标和图片的类型 */
+export type IconMode = string | { light: string; dark: string }
+/** 尺寸类型 */
+export type SizeType = null | string | number
+/** 链接类型 */
+export type LinkType = string | undefined
+/** Rel 属性类型 */
+export type RelType = string | undefined
+/** 目标类型 */
+export type TargetType = string | undefined
+
+export type IconType =
+  | string
+  | { icon: string; color?: IconMode }
+  | { light: string; dark: string; color?: IconMode }
+  | { svg: IconMode }
+
+export type ImageType =
+  | string
+  | { src: string; crop?: boolean; [prop: string]: any }
+  | { light: string; dark: string; crop?: boolean; [prop: string]: any }
+
+/** Pill */
+export interface PillItem {
+  /** 名称 */
+  name: string
+  /** 链接 */
+  link?: LinkType
+  /** Rel 属性 */
+  rel?: RelType
+  /** 链接的目标 */
+  target?: TargetType
+  /** 图标配置 */
+  icon?: IconType
+  /** 图片配置 */
+  image?: ImageType
+  /** 图片和图标大小 @default '14' */
+  size?: SizeType
+}
+
+/** Links */
+export interface LinkItem {
+  /** 名称 */
+  name: string
+  /** 描述 */
+  desc?: string
+  /** 链接 */
+  link?: LinkType
+  /** 链接地址描述文本 */
+  linkText?: string
+  /** Rel 属性 */
+  rel?: RelType
+  /** 链接的目标 */
+  target?: TargetType
+  /** 图标配置 */
+  icon?: IconType
+  /** 图片配置 */
+  image?: ImageType
+  /** 图片和图标大小 @default '32' */
+  size?: SizeType
+}
+
+/** BoxCube */
+export interface BoxCubeItem {
+  /** 名称 */
+  name: string
+  /** 链接 */
+  link?: LinkType
+  /** Rel 属性 */
+  rel?: RelType
+  /** 链接的目标 */
+  target?: TargetType
+  /** 图标配置 */
+  icon?: IconType
+  /** 图片配置 */
+  image?: ImageType
+  /** 图片和图标大小 @default '32' */
+  size?: SizeType
+}
+
+/** Card */
+export interface CardItem {
+  /** 名称 */
+  name?: string
+  /** 描述 */
+  desc?: string
+  /** 链接 */
+  link?: LinkType
+  /** Rel 属性 */
+  rel?: RelType
+  /** 链接的目标 */
+  target?: TargetType
+  /** 图标配置 */
+  icon?: IconType
+  /** 图片配置 */
+  image?: ImageType
+  /** 图片和图标大小 @default '48' */
+  size?: SizeType
+}
+
+/** CopyText */
+export interface CopyTextItem {
+  /** 颜色类型 @default 'auto' */
+  type?: 'auto' | 'info' | 'tip' | 'warning' | 'danger'
+  /** 显示的文本 */
+  label?: string
+  /** 复制按钮的文本内容 */
+  text: string
+  /** 复制成功后的提示文本 @default '已复制' */
+  toolTip?: string
+  /** 关闭图标 */
+  noIcon?: boolean
+  /** 图标配置 @default 'heroicons-outline:clipboard-copy' */
+  icon?: IconType
+  /** 图片配置 */
+  image?: ImageType
+  /** 提示显示的方向 @default 'top' */
+  toolTipPos?: 'top' | 'bottom' | 'left' | 'right'
+  /** 是否加粗文本 @default false */
+  bold?: boolean
+}
+
+/** Promo ：表示一个具有活动性质的推广项 */
+export interface Promo {
+  /** 活动标题 */
+  promo: string
+  /** 跳转链接 */
+  link?: LinkType
+  /** Rel 属性 */
+  rel?: RelType
+  /** 链接的目标 */
+  target?: TargetType
+  /** 附加信息1 */
+  info1?: string
+  /** 附加信息2 */
+  info2?: string
+  /** 图标配置 */
+  icon?: IconType
+  /** 图片配置 */
+  image?: ImageType
+  /** 图片和图标大小 @default '32' */
+  size?: SizeType
+}
+
+/** Normal ：表示普通链接项 */
+export interface Normal {
+  /** 名称标题 */
+  name: string
+  /** 跳转链接 */
+  link?: LinkType
+  /** Rel 属性 */
+  rel?: RelType
+  /** 链接的目标 */
+  target?: TargetType
+  /** 隐藏信息1（可用于鼠标悬停显示） */
+  hide1?: string
+  /** 隐藏信息2 */
+  hide2?: string
+  /** 图标配置 */
+  icon?: IconType
+  /** 图片配置 */
+  image?: ImageType
+  /** 图片和图标大小 @default '32' */
+  size?: SizeType
+}
+
+/** AsidePromo ：继承 Promo，同时支持 i18n 局部多语言（排除递归） */
+export type AsidePromo = Promo & {
+  /** 可选的多语言翻译字段，键为语言代码 */
+  i18n?: Partial<Record<string, Omit<AsidePromo, 'i18n'>>>
+}
+
+/** AsideNormal ：继承 Normal，同时支持 i18n 局部多语言（排除递归） */
+export type AsideNormal = Normal & {
+  /** 可选的多语言翻译字段，键为语言代码 */
+  i18n?: Partial<Record<string, Omit<AsideNormal, 'i18n'>>>
+}
+
+/** AsideAll ：联合类型，允许是 Promo 或 Normal */
+export type AsideAll = AsidePromo | AsideNormal
+
+/**
+ * AsideItem ：支持两种结构
+ *
+ * 单语言：直接是 AsideAll[] 数组
+ *
+ * 多语言：包裹在 i18n 对象中，按语言划分不同的 AsideAll[] 内容
+ */
+export type AsideItem = AsideAll[] | { i18n: Record<string, AsideAll[]> }
+
+/** Notice */
+export interface NoticeItem {
+  /** 链接 */
+  link?: LinkType
+  /** Rel 属性 */
+  rel?: RelType
+  /** 链接的目标 */
+  target?: TargetType
+  /** 链接的标题 */
+  title: string
+  /** 链接的内容 */
+  desc?: string
+  /** 日期 */
+  date?: string
+  /** 日期文本 */
+  dateText?: string
+  /** 日期图标 @default 'heroicons:calendar-days' */
+  dateIcon?: IconType
+  /** 日期图片 */
+  dateImage?: ImageType
+}
+
+/** Footer */
+export interface FooterData {
+  i18n?: Record<string, Partial<Omit<FooterData, 'i18n'>>>
+  /** 链接分组数组 */
+  group?: Group[]
+  /** 备案信息 */
+  beian?: Beian
+  /** 作者信息 */
+  author?: Author
+  /** 外部链接图标开关 */
+  noIcon?: boolean
+}
+
+/** Footer_Group */
+export interface Group {
+  /** 图标配置 */
+  icon?: IconType
+  /** 图片配置 */
+  image?: ImageType
+  /** 外部链接图标开关 */
+  noIcon?: boolean
+  /** 分组标题 */
+  title: string
+  /** 链接数组 */
+  links: Link[]
+}
+
+/** Footer_Beian */
+export interface Beian {
+  /** ICP 备案 */
+  icp?: Icp
+  /** 公安备案 */
+  police?: Police
+  /** 是否显示图标 */
+  showIcon?: boolean
+}
+
+/** Footer_Beian_Icp */
+export interface Icp {
+  /** ICP 备案号 */
+  number?: string
+  /** ICP 图标 */
+  icon?: IconType
+  /** 图片配置 */
+  image?: ImageType
+  /** ICP网站或自定义链接 */
+  link?: LinkType
+  /** Rel 属性 */
+  rel?: RelType
+  /** 链接的目标 */
+  target?: TargetType
+}
+
+/** Footer_Beian_Police */
+export interface Police {
+  /** 公安备案号 */
+  number?: string
+  /** 公安备案图标 */
+  icon?: IconType
+  /** 图片配置 */
+  image?: ImageType
+  /** 公安备案网站或自定义链接 */
+  link?: LinkType
+  /** Rel 属性 */
+  rel?: RelType
+  /** 链接的目标 */
+  target?: TargetType
+}
+
+/** Footer_Author */
+export interface Author {
+  /** 版权图标配置 @default 'ri:copyright-line' */
+  icon?: IconType
+  /** 版权图片配置 */
+  image?: ImageType
+  /** 版权起始年份 */
+  startYear?: number
+  /** 作者姓名 */
+  name?: string
+  /** 作者链接 */
+  link?: LinkType
+  /** Rel 属性 */
+  rel?: RelType
+  /** 链接的目标 */
+  target?: TargetType
+  /** 版权文本 */
+  text?: string
+}
+
+/** Footer_Link */
+export interface Link {
+  /** 链接图标 */
+  icon?: IconType
+  /** 图片配置 */
+  image?: ImageType
+  /** 外部链接图标开关 */
+  noIcon?: boolean
+  /** 链接名称 */
+  name: string
+  /** 链接地址 */
+  link: LinkType
+  /** Rel 属性 */
+  rel?: RelType
+  /** 链接的目标 */
+  target?: TargetType
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.