@funhub/platform 0.1.10 → 0.1.15

package/dist/components/biz/business/search-bar/variants/tag-search-bar/types.d.mts

@@ -0,0 +1,2 @@
+
+import "../../../../utils/index.mjs";

package/dist/components/biz/business/search-history/index.mjs

@@ -0,0 +1,2 @@
+
+"use client";import{useSearchHistory as e}from"./use-search-history.mjs";import{useImperativeHandle as t}from"react";import{jsx as n,jsxs as r}from"react/jsx-runtime";import{useTranslations as i}from"next-intl";function a({ref:a,storageKey:o,maxItems:s=10,onHistoryClick:c,onHistoryDelete:l,className:u=``,showClearButton:d=!0}){let f=i(`components.biz.business.searchHistory`),{history:p,addHistory:m,removeHistory:h,clearHistory:g}=e({storageKey:o,maxItems:s});t(a,()=>({addHistory:m,removeHistory:h,clearHistory:g,getHistory:()=>p}),[m,h,g,p]);let _=e=>{c?.(e)},v=e=>{h(e),l?.(e)};return p.length===0?null:r(`div`,{className:`w-full bg-bg1 pt-[8px] ${u}`,children:[n(`ul`,{className:`list-none m-0 p-0 w-full`,children:p.map((e,t)=>r(`li`,{className:`w-full h-[40px] px-[40px] relative`,children:[n(`svg`,{className:`w-[16px] h-[16px] text-text1 absolute left-[16px] top-[0] bottom-[0] m-auto`,viewBox:`0 0 16 16`,fill:`none`,xmlns:`http://www.w3.org/2000/svg`,children:n(`path`,{d:`M8 16C3.58171 16 0 12.4183 0 8C0 3.58171 3.58171 0 8 0C12.4183 0 16 3.58171 16 8C16 12.4183 12.4183 16 8 16ZM8 14.5714C11.6293 14.5714 14.5714 11.6293 14.5714 8C14.5714 4.37071 11.6293 1.42857 8 1.42857C4.37071 1.42857 1.42857 4.37071 1.42857 8C1.42857 11.6293 4.37071 14.5714 8 14.5714ZM11.1138 10.5351C11.3705 10.8347 11.3358 11.2856 11.0363 11.5423C10.7368 11.7991 10.2858 11.7644 10.0291 11.4649L7.45768 8.46486C7.34671 8.3354 7.28571 8.17051 7.28571 8V3.71429C7.28571 3.3198 7.60552 3 8 3C8.39448 3 8.71429 3.3198 8.71429 3.71429V7.73577L11.1138 10.5351Z`,fill:`currentColor`})}),n(`div`,{onClick:()=>{_(e)},className:`w-full leading-[40px] text-text1 text-[16px] line-clamp-1`,children:e}),n(`div`,{onClick:()=>{v(e)},className:`w-[40px] h-full px-[12px] absolute right-[0] top-[0] flex items-center`,children:n(`svg`,{xmlns:`http://www.w3.org/2000/svg`,className:`w-[12px] h-[12px] text-text2 pointer-events-none`,viewBox:`0 0 16 16`,fill:`currentColor`,children:n(`path`,{d:`M14.55.2a.889.889 0 0 1 1.25 1.25l-.06.067L9.255 8l6.483 6.482.06.069a.888.888 0 0 1-1.25 1.25l-.067-.062L8 9.256l-6.482 6.483A.888.888 0 1 1 .26 14.482L6.742 8 .26 1.517.2 1.45A.888.888 0 0 1 1.45.2l.067.062 6.482 6.482L14.482.261l.068-.062Z`})})})]},`${e}-${t}`))}),d&&p.length>0&&r(`div`,{className:`w-[fit-content] mx-auto px-[16px] py-[8px] leading-[24px] text-text3 text-[14px]`,onClick:()=>{g()},children:[n(`span`,{children:f(`clearAllHistory`)}),n(`svg`,{className:`hidden`,viewBox:`0 0 1024 1024`,version:`1.1`,xmlns:`http://www.w3.org/2000/svg`,"p-id":`9397`,width:`200`,height:`200`,children:n(`path`,{d:`M720.596674 189.629047V75.854767C720.596674 28.711163 691.05125 0 642.805792 0H381.225689c-48.166754 0-77.743659 28.711163-77.743659 75.854767v113.77428H75.854767v75.854766h75.854767v644.741907c0 68.34642 42.783411 113.77428 113.774279 113.77428H758.531927c69.353829 0 113.77428-42.169521 113.77428-113.77428v-644.741907h75.839026v-75.854766zM379.258093 75.854767h265.483814l-1.574077 113.77428H379.258093z m417.130384 872.290466H227.54856V265.483813h568.90288z m-341.275617-606.806653H381.225689l-1.904633 493.032373h75.854767z m189.629047 0h-75.854767v493.032373h75.854767z m0 0`,"p-id":`9398`,fill:`currentColor`})})]})]})}a.displayName=`SearchHistory`;export{a as SearchHistory};

package/dist/components/biz/business/search-history/use-search-history.mjs

@@ -0,0 +1,2 @@
+
+import{useCallback as e,useEffect as t,useState as n}from"react";function r(r){let{storageKey:i,maxItems:a=10}=r,[o,s]=n([]),c=`search-history-${i}`,l=e(()=>{if(typeof window>`u`)return[];try{let e=localStorage.getItem(c);if(!e)return[];let t=JSON.parse(e);return Array.isArray(t.keywords)?t.keywords.slice(0,a):[]}catch(e){return console.error(`读取搜索历史失败:`,e),[]}},[c,a]),u=e(e=>{if(!(typeof window>`u`))try{let t={keywords:e,timestamp:Date.now()};localStorage.setItem(c,JSON.stringify(t))}catch(e){console.error(`保存搜索历史失败:`,e)}},[c]);return t(()=>{s(l())},[l]),{history:o,addHistory:e(e=>{if(!e||typeof e!=`string`)return;let t=e.trim();if(!t)return;let n=[t,...l().filter(e=>e!==t)].slice(0,a);u(n),s(n)},[a,u,l]),removeHistory:e(e=>{e&&s(t=>{let n=t.filter(t=>t!==e);return u(n),n})},[u]),clearHistory:e(()=>{s([]),u([])},[u])}}export{r as useSearchHistory};

package/dist/components/biz/example/button/client.d.mts

@@ -0,0 +1,8 @@
+
+import { ButtonProps } from "./schema.mjs";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region components/biz/example/button/client.d.ts
+declare function ButtonClient(props: ButtonProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { ButtonClient };

package/dist/components/biz/example/button/client.mjs

@@ -0,0 +1,2 @@
+
+"use client";import{cn as e}from"../../../../utils/cn.mjs";import{useRequest as t}from"../../../../hooks/query/use-query.mjs";import{useAppContext as n}from"../../../../hooks/use-app-context/index.mjs";import{buttonVariants as r}from"./variants.mjs";import{jsx as i}from"react/jsx-runtime";function a(a){let{children:o,disabled:s,loading:c,variant:l=`default`}=a,u=n();console.log({clientContext:u});function d(){u!==`editor`&&console.log(`invoke`)}return t([`demo`],()=>new Promise(e=>{setTimeout(()=>{e({message:`Hello World`})},200)}),{enabled:u===`renderer`}),u===`editor`?i(`div`,{children:`editor preview button`}):i(`button`,{className:e(r({variant:l})),onClick:d,disabled:s||c,children:o})}export{a as ButtonClient};

package/dist/components/biz/example/button/index.d.mts

@@ -0,0 +1,5 @@
+
+import { ButtonInspectorProps, ButtonProps, buttonInspectorDefaultProps, buttonInspectorPropsSchema } from "./schema.mjs";
+import { ButtonClient } from "./client.mjs";
+import { Button } from "./server.mjs";
+import { exampleButtonMaterial } from "./material.mjs";

package/dist/components/biz/example/button/material.d.mts

@@ -0,0 +1,22 @@
+
+import { SchemaHasDefaultValue } from "../../../../utils/schema/schema.mjs";
+import { DefineMaterialOption } from "../../../../utils/schema/material.mjs";
+import "../../../../utils/schema/index.mjs";
+import { Button } from "./server.mjs";
+import * as zod from "zod";
+import * as zod_v4_core0 from "zod/v4/core";
+
+//#region components/biz/example/button/material.d.ts
+declare const exampleButtonMaterial: DefineMaterialOption<typeof Button, zod.ZodObject<{
+  variant: zod.ZodType<"default" | "blue" | "red", unknown, zod_v4_core0.$ZodTypeInternals<"default" | "blue" | "red", unknown>> & SchemaHasDefaultValue;
+  disabled: zod.ZodBoolean & SchemaHasDefaultValue;
+  loading: zod.ZodOptional<zod.ZodBoolean>;
+  items: zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
+    name: zod.ZodOptional<zod.ZodString> & SchemaHasDefaultValue;
+  }, zod_v4_core0.$strip>>> & SchemaHasDefaultValue;
+  info: zod.ZodOptional<zod.ZodObject<{
+    readonly address: zod.ZodOptional<zod.ZodString>;
+  }, zod_v4_core0.$strip>> & SchemaHasDefaultValue;
+}, zod_v4_core0.$strip>, "example-button">;
+//#endregion
+export { exampleButtonMaterial };

package/dist/components/biz/example/button/material.mjs

@@ -0,0 +1,2 @@
+
+import{defineMaterial as e}from"../../../../utils/schema/material.mjs";import{buttonInspectorPropsSchema as t}from"./schema.mjs";import{Button as n}from"./server.mjs";const r=e({type:`example-button`,name:`按钮`,icon:`/icon/button.png`,category:`TOP`,component:n,propsSchema:t});export{r as exampleButtonMaterial};

package/dist/components/biz/example/button/schema.d.mts

@@ -0,0 +1,38 @@
+
+import { SchemaHasDefaultValue } from "../../../../utils/schema/schema.mjs";
+import "../../../../utils/schema/index.mjs";
+import { PropsWithChildren } from "react";
+import z from "zod";
+
+//#region components/biz/example/button/schema.d.ts
+/**
+ * 定义可以被低代码右侧inspector编辑的props
+ */
+declare const buttonInspectorPropsSchema: z.ZodObject<{
+  variant: z.ZodType<"default" | "blue" | "red", unknown, z.core.$ZodTypeInternals<"default" | "blue" | "red", unknown>> & SchemaHasDefaultValue;
+  disabled: z.ZodBoolean & SchemaHasDefaultValue;
+  loading: z.ZodOptional<z.ZodBoolean>;
+  items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    name: z.ZodOptional<z.ZodString> & SchemaHasDefaultValue;
+  }, z.core.$strip>>> & SchemaHasDefaultValue;
+  info: z.ZodOptional<z.ZodObject<{
+    readonly address: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>> & SchemaHasDefaultValue;
+}, z.core.$strip>;
+declare const buttonInspectorDefaultProps: {
+  variant: "default" | "blue" | "red";
+  disabled: boolean;
+  items: {
+    name?: string | undefined;
+  }[];
+  info: {
+    address?: string | undefined;
+  };
+};
+type ButtonInspectorProps<T extends object = object> = z.infer<typeof buttonInspectorPropsSchema> & T;
+/**
+ * 基于ButtonInspectorProps再派生出组件真正的props（因为不是所有props都需要被编辑，比如说下面的children就不需要，但是button组件又需要传入children）
+ */
+type ButtonProps = ButtonInspectorProps<PropsWithChildren>;
+//#endregion
+export { ButtonInspectorProps, ButtonProps, buttonInspectorDefaultProps, buttonInspectorPropsSchema };

package/dist/components/biz/example/button/schema.mjs

@@ -0,0 +1,2 @@
+
+import{defineArrayItemPropSchema as e,defineCheckboxPropSchema as t,defineComponentPropsSchema as n,defineObjectPropSchema as r,defineSelectEnumPropSchema as i,defineSwitchPropSchema as a,defineTextPropSchema as o,getSchemaDefaultProps as s}from"../../../../utils/schema/schema.mjs";import{buttonVariantOptions as c}from"./variants.mjs";import l from"zod";const u=n({variant:i(c,{label:`变体`,defaultValue:`red`}),disabled:t({label:`禁用`,defaultValue:!1}),loading:a({label:`加载`,required:!1}),items:e(l.object({name:o({label:`名称`,required:!1,defaultValue:`wuhu`})}),{required:!1,label:`items`,defaultValue:[{name:`string`}]}),info:r({address:o({label:`地址`,required:!1})},{label:`info`,required:!1,defaultValue:{address:`SHENZHEN`}})}),d=s(u);export{d as buttonInspectorDefaultProps,u as buttonInspectorPropsSchema};

package/dist/components/biz/example/button/server.d.mts

@@ -0,0 +1,8 @@
+
+import { ButtonProps } from "./schema.mjs";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region components/biz/example/button/server.d.ts
+declare function Button(props: ButtonProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { Button };

package/dist/components/biz/example/button/server.mjs

@@ -0,0 +1,2 @@
+
+import{getAppContext as e}from"../../../../hooks/get-app-context.mjs";import{HydrationBoundary as t}from"../../../../hooks/query/hydration-boundary.mjs";import{ButtonClient as n}from"./client.mjs";import{jsx as r}from"react/jsx-runtime";function i(i){let a=e();return console.log({serverContext:a}),r(t,{prefetch:[{queryKey:[`demo`],queryFn(){return new Promise(e=>{setTimeout(()=>{e({message:`Hello World`})},200)})}}],children:r(n,{...i})})}export{i as Button};

package/dist/components/biz/example/button/variants.mjs

@@ -0,0 +1,2 @@
+
+import{cva as e}from"class-variance-authority";const t=e(`transition-colors duration-150 active:opacity-50 border p-2 rounded-md`,{variants:{variant:{default:`bg-white text-white`,blue:`bg-blue-400 text-white`,red:`bg-red-600 text-white`}},defaultVariants:{variant:`default`}}),n=[`default`,`blue`,`red`];export{n as buttonVariantOptions,t as buttonVariants};

package/dist/components/biz/utils/constants/card-spec.d.mts

@@ -0,0 +1,63 @@
+
+//#region components/biz/utils/constants/card-spec.d.ts
+/**
+ * CardSpec 卡片规格体系
+ */
+declare enum CardSpec {
+  /** 横屏，一行 2 个（199 × 128） */
+  H2_SMALL = "h2_small",
+  /** 竖屏，一行 3 个（130 × 175） */
+  V3_SMALL = "v3_small",
+  /** 竖屏，一行 2 个（199 × 268） */
+  V2_LARGE = "v2_large"
+}
+/**
+ * 卡片规格配置映射
+ */
+declare const CARD_SPEC_MAP: {
+  readonly h2_small: {
+    readonly columns: 2;
+    readonly width: 199;
+    readonly height: 128;
+    readonly imageType: "horizontal";
+    readonly aspectRatio: number;
+  };
+  readonly v3_small: {
+    readonly columns: 3;
+    readonly width: 130;
+    readonly height: 175;
+    readonly imageType: "vertical";
+    readonly aspectRatio: number;
+  };
+  readonly v2_large: {
+    readonly columns: 2;
+    readonly width: 199;
+    readonly height: 268;
+    readonly imageType: "vertical";
+    readonly aspectRatio: number;
+  };
+};
+/**
+ * 获取卡片规格配置
+ */
+declare function getCardSpecConfig(spec: CardSpec): {
+  readonly columns: 2;
+  readonly width: 199;
+  readonly height: 128;
+  readonly imageType: "horizontal";
+  readonly aspectRatio: number;
+} | {
+  readonly columns: 3;
+  readonly width: 130;
+  readonly height: 175;
+  readonly imageType: "vertical";
+  readonly aspectRatio: number;
+} | {
+  readonly columns: 2;
+  readonly width: 199;
+  readonly height: 268;
+  readonly imageType: "vertical";
+  readonly aspectRatio: number;
+};
+//#endregion
+export { CARD_SPEC_MAP, CardSpec, getCardSpecConfig };

package/dist/components/biz/utils/constants/card-spec.mjs

@@ -0,0 +1,2 @@
+
+let e=function(e){return e.H2_SMALL=`h2_small`,e.V3_SMALL=`v3_small`,e.V2_LARGE=`v2_large`,e}({});const t={[e.H2_SMALL]:{columns:2,width:199,height:128,imageType:`horizontal`,aspectRatio:199/128},[e.V3_SMALL]:{columns:3,width:130,height:175,imageType:`vertical`,aspectRatio:130/175},[e.V2_LARGE]:{columns:2,width:199,height:268,imageType:`vertical`,aspectRatio:199/268}};function n(e){return t[e]}export{t as CARD_SPEC_MAP,e as CardSpec,n as getCardSpecConfig};

package/dist/components/biz/utils/helpers/url.d.mts

@@ -0,0 +1,16 @@
+
+//#region components/biz/utils/helpers/url.d.ts
+/**
+ * URL 生成工具函数
+ */
+/**
+ * 根据内容类型和 ID 构建内容详情页 URL
+ */
+declare function buildContentUrl(options: {
+  url: string;
+  contentId: string;
+  contentType: number;
+  title: string;
+}): string;
+//#endregion
+export { buildContentUrl };

package/dist/components/biz/utils/helpers/url.mjs

@@ -0,0 +1,2 @@
+
+function e(e){let{url:t,contentId:n,contentType:r,title:i}=e;return r===1?`/video/${n}/${i}`:r===2?`/post/${n}`:t}export{e as buildContentUrl};

package/dist/components/biz/utils/index.d.mts

@@ -0,0 +1,16 @@
+
+import { CARD_SPEC_MAP, CardSpec, getCardSpecConfig } from "./constants/card-spec.mjs";
+import { buildContentUrl } from "./helpers/url.mjs";
+import { FieldSchema, FieldType } from "./schema/field.mjs";
+import { DataBinding, DataBindingField, DataBindingSourceType, DataBindingUIMode, DataSchema, DataSlot, DataSourceType } from "./schema/data.mjs";
+import { PropDefinition, PropSchema } from "./schema/prop.mjs";
+import { EventDefinition, EventSchema } from "./schema/event.mjs";
+import { CommonStyleSchema, StylePropDefinition, StyleSchema } from "./schema/style.mjs";
+import { ComponentMaterial, ComponentSchema, MaterialRegistry } from "./schema/component.mjs";
+import { commonStylesToInline, customStylesToInline, mergeStyles } from "./styles/helpers.mjs";
+import { commonStyleSchema } from "./styles/schema.mjs";
+import { CardCornerMode, RawContentData, transformContentListToCardItems, transformContentToCardItem } from "./transformers/card-grid.mjs";
+import { ComponentType, ContentBlockItem, ExtractedDataItem, extractDataByComponentType } from "./transformers/data.mjs";
+import "./transformers/index.mjs";
+import { ChannelDataItem } from "./types/channel.mjs";
+import { BaseComponentProps } from "./types/component.mjs";

package/dist/components/biz/utils/schema/component.d.mts

@@ -0,0 +1,45 @@
+
+import { DataSchema } from "./data.mjs";
+import { PropSchema } from "./prop.mjs";
+import { EventSchema } from "./event.mjs";
+import { StyleSchema } from "./style.mjs";
+
+//#region components/biz/utils/schema/component.d.ts
+/**
+ * 组件 Schema 协议
+ */
+interface ComponentSchema {
+  /** 组件唯一标识 */
+  componentName: string;
+  /** 组件显示名称 */
+  displayName: string;
+  /** 组件分类 */
+  category: string;
+  /** 组件分类名称 */
+  categoryName: string;
+  /** 组件属性 Schema */
+  propsSchema: PropSchema;
+  /** 组件数据 Schema */
+  dataSchema: DataSchema;
+  /** 组件样式配置 */
+  styleSchema?: StyleSchema;
+  /** 组件事件 Schema */
+  eventSchema?: EventSchema;
+  /** 是否在低代码平台启用 */
+  enabled: boolean;
+}
+/**
+ * 组件物料配置
+ */
+interface ComponentMaterial {
+  /** 组件 Schema */
+  schema: ComponentSchema;
+  /** 组件加载函数 */
+  component: () => Promise<React.ComponentType<any>>;
+}
+/**
+ * 物料注册表
+ */
+type MaterialRegistry = Record<string, ComponentMaterial>;
+//#endregion
+export { ComponentMaterial, ComponentSchema, MaterialRegistry };

package/dist/components/biz/utils/schema/data.d.mts

@@ -0,0 +1,63 @@
+
+import { FieldSchema } from "./field.mjs";
+
+//#region components/biz/utils/schema/data.d.ts
+/**
+ * 数据绑定 UI 模式枚举
+ */
+declare enum DataBindingUIMode {
+  /** 页面字段选择 */
+  PageFieldSelect = "PageFieldSelect"
+}
+/**
+ * 数据源类型枚举
+ */
+declare enum DataSourceType {
+  /** API 请求 */
+  API = "API",
+  /** 静态数据 */
+  Static = "Static"
+}
+/**
+ * 数据绑定字段类型
+ */
+type DataBindingField = 'banner' | 'banners' | 'videos' | 'icons' | 'users' | 'contents' | 'navs';
+/**
+ * 数据绑定源类型
+ */
+type DataBindingSourceType = 'static' | 'dynamic';
+/**
+ * 数据绑定配置
+ */
+interface DataBinding {
+  /** 数据字段名 */
+  field: DataBindingField;
+  /** 数据源类型 */
+  sourceType: DataBindingSourceType;
+}
+/**
+ * 数据槽位定义（仅用于静态组件）
+ */
+interface DataSlot {
+  /** 数据槽标题 */
+  title: string;
+  /** 数据槽描述 */
+  description?: string;
+  /** 数据结构定义（核心） */
+  schema: FieldSchema;
+  /** 是否必填 */
+  required: boolean;
+}
+/**
+ * 数据 Schema 定义
+ */
+interface DataSchema {
+  /** 数据绑定配置 */
+  dataBinding: DataBinding;
+  /** 数据槽位定义（仅静态组件需要） */
+  slots?: {
+    data: DataSlot;
+  };
+}
+//#endregion
+export { DataBinding, DataBindingField, DataBindingSourceType, DataBindingUIMode, DataSchema, DataSlot, DataSourceType };

package/dist/components/biz/utils/schema/data.mjs

@@ -0,0 +1,2 @@
+
+let e=function(e){return e.PageFieldSelect=`PageFieldSelect`,e}({}),t=function(e){return e.API=`API`,e.Static=`Static`,e}({});export{e as DataBindingUIMode,t as DataSourceType};

package/dist/components/biz/utils/schema/event.d.mts

@@ -0,0 +1,24 @@
+
+import { PropDefinition } from "./prop.mjs";
+
+//#region components/biz/utils/schema/event.d.ts
+/**
+ * 事件 Schema 定义
+ */
+interface EventSchema {
+  /** 事件定义 */
+  [key: string]: EventDefinition;
+}
+/**
+ * 事件定义
+ */
+interface EventDefinition {
+  /** 事件标题 */
+  title: string;
+  /** 事件描述 */
+  description?: string;
+  /** 事件参数 Schema（可选） */
+  params?: PropDefinition[];
+}
+//#endregion
+export { EventDefinition, EventSchema };

package/dist/components/biz/utils/schema/field.d.mts

@@ -0,0 +1,29 @@
+
+//#region components/biz/utils/schema/field.d.ts
+/**
+ * FieldSchema 字段结构定义
+ */
+type FieldType = 'string' | 'number' | 'boolean' | 'object' | 'array';
+/**
+ * 字段结构定义（递归结构）
+ *
+ * 示例：
+ * - 字符串字段：{ type: 'string', title: '名称' }
+ * - 对象字段：{ type: 'object', fields: { id: { type: 'string' } } }
+ * - 数组字段：{ type: 'array', item: { type: 'string' } }
+ * - 数组套对象：{ type: 'array', item: { type: 'object', fields: {...} } }
+ */
+interface FieldSchema {
+  /** 字段类型 */
+  type: FieldType;
+  /** 字段标题（用于编辑器展示） */
+  title?: string;
+  /** 字段描述 */
+  description?: string;
+  /** object 专用：字段结构定义 */
+  fields?: Record<string, FieldSchema>;
+  /** array 专用：数组项结构定义 */
+  item?: FieldSchema;
+}
+//#endregion
+export { FieldSchema, FieldType };

package/dist/components/biz/utils/schema/prop.d.mts

@@ -0,0 +1,46 @@
+
+//#region components/biz/utils/schema/prop.d.ts
+/**
+ * 属性 Schema 定义
+ */
+/**
+ * 属性 Schema 定义
+ * 扁平化设计：直接包含属性定义和 required 字段
+ */
+interface PropSchema {
+  /** 属性定义（使用索引签名，但排除 required） */
+  [key: string]: PropDefinition | string[] | undefined;
+  /** 必需属性列表 */
+  required?: string[];
+}
+/**
+ * 属性定义
+ */
+interface PropDefinition {
+  /** 属性类型 */
+  type: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'enum' | 'function';
+  /** 属性标题 */
+  title: string;
+  /** 属性描述 */
+  description?: string;
+  /** 默认值 */
+  default?: any;
+  /** 枚举值（当 type 为 enum 时） */
+  enum?: any[];
+  /** 枚举标签（当 type 为 enum 时） */
+  enumNames?: string[];
+  /** 最小值（当 type 为 number 时） */
+  minimum?: number;
+  /** 最大值（当 type 为 number 时） */
+  maximum?: number;
+  /** 最小长度（当 type 为 string 或 array 时） */
+  minLength?: number;
+  /** 最大长度（当 type 为 string 或 array 时） */
+  maxLength?: number;
+  /** 数组项 Schema（当 type 为 array 时） */
+  items?: PropDefinition;
+  /** 对象属性 Schema（当 type 为 object 时） */
+  properties?: Record<string, PropDefinition>;
+}
+//#endregion
+export { PropDefinition, PropSchema };

package/dist/components/biz/utils/schema/style.d.mts

@@ -0,0 +1,75 @@
+
+//#region components/biz/utils/schema/style.d.ts
+/**
+ * 样式 Schema 定义
+ */
+/**
+ * 样式属性定义
+ */
+interface StylePropDefinition {
+  /** 样式属性类型 */
+  type: 'string' | 'number' | 'color' | 'size' | 'spacing' | 'enum';
+  /** 样式属性标题 */
+  title: string;
+  /** 样式属性描述 */
+  description?: string;
+  /** 默认值 */
+  default?: any;
+  /** 枚举值（当 type 为 enum 时） */
+  enum?: any[];
+  /** 枚举标签（当 type 为 enum 时） */
+  enumNames?: string[];
+}
+/**
+ * 通用样式 Schema（所有组件都支持的样式）
+ */
+interface CommonStyleSchema {
+  width?: StylePropDefinition;
+  height?: StylePropDefinition;
+  minWidth?: StylePropDefinition;
+  minHeight?: StylePropDefinition;
+  maxWidth?: StylePropDefinition;
+  maxHeight?: StylePropDefinition;
+  padding?: StylePropDefinition;
+  paddingTop?: StylePropDefinition;
+  paddingRight?: StylePropDefinition;
+  paddingBottom?: StylePropDefinition;
+  paddingLeft?: StylePropDefinition;
+  margin?: StylePropDefinition;
+  marginTop?: StylePropDefinition;
+  marginRight?: StylePropDefinition;
+  marginBottom?: StylePropDefinition;
+  marginLeft?: StylePropDefinition;
+  fontSize?: StylePropDefinition;
+  fontWeight?: StylePropDefinition;
+  lineHeight?: StylePropDefinition;
+  color?: StylePropDefinition;
+  backgroundColor?: StylePropDefinition;
+  border?: StylePropDefinition;
+  borderWidth?: StylePropDefinition;
+  borderStyle?: StylePropDefinition;
+  borderColor?: StylePropDefinition;
+  borderRadius?: StylePropDefinition;
+  boxShadow?: StylePropDefinition;
+  opacity?: StylePropDefinition;
+  display?: StylePropDefinition;
+  position?: StylePropDefinition;
+  top?: StylePropDefinition;
+  right?: StylePropDefinition;
+  bottom?: StylePropDefinition;
+  left?: StylePropDefinition;
+  zIndex?: StylePropDefinition;
+  overflow?: StylePropDefinition;
+  textAlign?: StylePropDefinition;
+  cursor?: StylePropDefinition;
+}
+/**
+ * 样式 Schema 定义
+ * 扁平化结构，所有样式字段都在顶层
+ */
+interface StyleSchema extends CommonStyleSchema {
+  /** 组件私有样式（扩展字段） */
+  [key: string]: StylePropDefinition | undefined;
+}
+//#endregion
+export { CommonStyleSchema, StylePropDefinition, StyleSchema };

package/dist/components/biz/utils/styles/helpers.d.mts

@@ -0,0 +1,18 @@
+
+import { CommonStyleSchema } from "../schema/style.mjs";
+
+//#region components/biz/utils/styles/helpers.d.ts
+/**
+ * 将通用样式转换为内联样式对象
+ */
+declare function commonStylesToInline(styles: Partial<Record<keyof CommonStyleSchema, any>>): React.CSSProperties;
+/**
+ * 将自定义样式转换为内联样式对象
+ */
+declare function customStylesToInline(customStyles: Record<string, any>): React.CSSProperties;
+/**
+ * 合并通用样式和自定义样式
+ */
+declare function mergeStyles(commonStyles?: Partial<Record<keyof CommonStyleSchema, any>>, customStyles?: Record<string, any>): React.CSSProperties;
+//#endregion
+export { commonStylesToInline, customStylesToInline, mergeStyles };

package/dist/components/biz/utils/styles/helpers.mjs

@@ -0,0 +1,2 @@
+
+function e(e,t){return t==null||t===``?``:typeof t==`number`&&![`opacity`,`zIndex`,`fontWeight`,`lineHeight`].includes(e)?`${t}px`:String(t)}function t(t){let n={};return t.width!==void 0&&(n.width=e(`width`,t.width)),t.height!==void 0&&(n.height=e(`height`,t.height)),t.minWidth!==void 0&&(n.minWidth=e(`minWidth`,t.minWidth)),t.minHeight!==void 0&&(n.minHeight=e(`minHeight`,t.minHeight)),t.maxWidth!==void 0&&(n.maxWidth=e(`maxWidth`,t.maxWidth)),t.maxHeight!==void 0&&(n.maxHeight=e(`maxHeight`,t.maxHeight)),t.padding!==void 0&&(n.padding=e(`padding`,t.padding)),t.paddingTop!==void 0&&(n.paddingTop=e(`paddingTop`,t.paddingTop)),t.paddingRight!==void 0&&(n.paddingRight=e(`paddingRight`,t.paddingRight)),t.paddingBottom!==void 0&&(n.paddingBottom=e(`paddingBottom`,t.paddingBottom)),t.paddingLeft!==void 0&&(n.paddingLeft=e(`paddingLeft`,t.paddingLeft)),t.margin!==void 0&&(n.margin=e(`margin`,t.margin)),t.marginTop!==void 0&&(n.marginTop=e(`marginTop`,t.marginTop)),t.marginRight!==void 0&&(n.marginRight=e(`marginRight`,t.marginRight)),t.marginBottom!==void 0&&(n.marginBottom=e(`marginBottom`,t.marginBottom)),t.marginLeft!==void 0&&(n.marginLeft=e(`marginLeft`,t.marginLeft)),t.fontSize!==void 0&&(n.fontSize=e(`fontSize`,t.fontSize)),t.fontWeight!==void 0&&(n.fontWeight=e(`fontWeight`,t.fontWeight)),t.lineHeight!==void 0&&(n.lineHeight=e(`lineHeight`,t.lineHeight)),t.color!==void 0&&(n.color=e(`color`,t.color)),t.backgroundColor!==void 0&&(n.backgroundColor=e(`backgroundColor`,t.backgroundColor)),t.border!==void 0&&(n.border=e(`border`,t.border)),t.borderWidth!==void 0&&(n.borderWidth=e(`borderWidth`,t.borderWidth)),t.borderStyle!==void 0&&(n.borderStyle=e(`borderStyle`,t.borderStyle)),t.borderColor!==void 0&&(n.borderColor=e(`borderColor`,t.borderColor)),t.borderRadius!==void 0&&(n.borderRadius=e(`borderRadius`,t.borderRadius)),t.boxShadow!==void 0&&(n.boxShadow=e(`boxShadow`,t.boxShadow)),t.opacity!==void 0&&(n.opacity=t.opacity),t.display!==void 0&&(n.display=e(`display`,t.display)),t.position!==void 0&&(n.position=e(`position`,t.position)),t.top!==void 0&&(n.top=e(`top`,t.top)),t.right!==void 0&&(n.right=e(`right`,t.right)),t.bottom!==void 0&&(n.bottom=e(`bottom`,t.bottom)),t.left!==void 0&&(n.left=e(`left`,t.left)),t.zIndex!==void 0&&(n.zIndex=t.zIndex),t.overflow!==void 0&&(n.overflow=e(`overflow`,t.overflow)),t.textAlign!==void 0&&(n.textAlign=e(`textAlign`,t.textAlign)),t.cursor!==void 0&&(n.cursor=e(`cursor`,t.cursor)),n}function n(t){let n={};for(let[r,i]of Object.entries(t))if(i!=null&&i!==``){let t=r.replace(/([A-Z])/g,`-$1`).toLowerCase();n[t]=e(r,i)}return n}function r(e,r){let i=t(e||{}),a=n(r||{});return{...i,...a}}export{t as commonStylesToInline,n as customStylesToInline,r as mergeStyles};

package/dist/components/biz/utils/styles/schema.d.mts

@@ -0,0 +1,7 @@
+
+import { CommonStyleSchema } from "../schema/style.mjs";
+
+//#region components/biz/utils/styles/schema.d.ts
+declare const commonStyleSchema: CommonStyleSchema;
+//#endregion
+export { commonStyleSchema };

package/dist/components/biz/utils/styles/schema.mjs

@@ -0,0 +1,2 @@
+
+const e={width:{type:`size`,title:`宽度`,description:`组件宽度`},height:{type:`size`,title:`高度`,description:`组件高度`},minWidth:{type:`size`,title:`最小宽度`,description:`组件最小宽度`},minHeight:{type:`size`,title:`最小高度`,description:`组件最小高度`},maxWidth:{type:`size`,title:`最大宽度`,description:`组件最大宽度`},maxHeight:{type:`size`,title:`最大高度`,description:`组件最大高度`},padding:{type:`spacing`,title:`内边距`,description:`组件内边距`},paddingTop:{type:`spacing`,title:`上内边距`,description:`组件上内边距`},paddingRight:{type:`spacing`,title:`右内边距`,description:`组件右内边距`},paddingBottom:{type:`spacing`,title:`下内边距`,description:`组件下内边距`},paddingLeft:{type:`spacing`,title:`左内边距`,description:`组件左内边距`},margin:{type:`spacing`,title:`外边距`,description:`组件外边距`},marginTop:{type:`spacing`,title:`上外边距`,description:`组件上外边距`},marginRight:{type:`spacing`,title:`右外边距`,description:`组件右外边距`},marginBottom:{type:`spacing`,title:`下外边距`,description:`组件下外边距`},marginLeft:{type:`spacing`,title:`左外边距`,description:`组件左外边距`},fontSize:{type:`size`,title:`字体大小`,description:`文字字体大小`},fontWeight:{type:`enum`,title:`字体粗细`,description:`文字字体粗细`,enum:[`normal`,`bold`,`100`,`200`,`300`,`400`,`500`,`600`,`700`,`800`,`900`],enumNames:[`正常`,`粗体`,`100`,`200`,`300`,`400`,`500`,`600`,`700`,`800`,`900`]},lineHeight:{type:`size`,title:`行高`,description:`文字行高`},color:{type:`color`,title:`文字颜色`,description:`文字颜色`},backgroundColor:{type:`color`,title:`背景颜色`,description:`背景颜色`},border:{type:`string`,title:`边框`,description:`边框样式（如：1px solid #000）`},borderWidth:{type:`size`,title:`边框宽度`,description:`边框宽度`},borderStyle:{type:`enum`,title:`边框样式`,description:`边框样式`,enum:[`none`,`solid`,`dashed`,`dotted`,`double`],enumNames:[`无`,`实线`,`虚线`,`点线`,`双线`]},borderColor:{type:`color`,title:`边框颜色`,description:`边框颜色`},borderRadius:{type:`size`,title:`圆角`,description:`边框圆角大小`},boxShadow:{type:`string`,title:`阴影`,description:`盒子阴影（如：0 2px 4px rgba(0,0,0,0.1)）`},opacity:{type:`number`,title:`透明度`,description:`透明度（0-1）`},display:{type:`enum`,title:`显示方式`,description:`元素的显示方式`,enum:[`block`,`inline`,`inline-block`,`flex`,`grid`,`none`],enumNames:[`块级`,`行内`,`行内块`,`弹性`,`网格`,`隐藏`]},position:{type:`enum`,title:`定位方式`,description:`元素的定位方式`,enum:[`static`,`relative`,`absolute`,`fixed`,`sticky`],enumNames:[`静态`,`相对`,`绝对`,`固定`,`粘性`]},top:{type:`size`,title:`顶部距离`,description:`距离顶部的距离`},right:{type:`size`,title:`右侧距离`,description:`距离右侧的距离`},bottom:{type:`size`,title:`底部距离`,description:`距离底部的距离`},left:{type:`size`,title:`左侧距离`,description:`距离左侧的距离`},zIndex:{type:`number`,title:`层级`,description:`元素的层级顺序`},overflow:{type:`enum`,title:`溢出处理`,description:`内容溢出时的处理方式`,enum:[`visible`,`hidden`,`scroll`,`auto`],enumNames:[`可见`,`隐藏`,`滚动`,`自动`]},textAlign:{type:`enum`,title:`文字对齐`,description:`文字对齐方式`,enum:[`left`,`center`,`right`,`justify`],enumNames:[`左对齐`,`居中`,`右对齐`,`两端对齐`]},cursor:{type:`enum`,title:`鼠标样式`,description:`鼠标悬停时的样式`,enum:[`default`,`pointer`,`text`,`not-allowed`,`wait`,`move`],enumNames:[`默认`,`手型`,`文本`,`禁止`,`等待`,`移动`]}};export{e as commonStyleSchema};

package/dist/components/biz/utils/transformers/card-grid.d.mts

@@ -0,0 +1,32 @@
+
+import { CardItemData } from "../../basics/card-item/types.mjs";
+
+//#region components/biz/utils/transformers/card-grid.d.ts
+/** 角标渲染模式：view-duration | category-score */
+type CardCornerMode = 'view-duration' | 'category-score';
+/** API 返回的原始内容数据结构 */
+interface RawContentData {
+  id: string;
+  name: string;
+  img_x: string;
+  img_y: string;
+  img_type: string;
+  episode_cnt: number;
+  update_status: string;
+  duration: number;
+  type: number;
+  static: {
+    browse_cnt: number;
+  };
+  score: number;
+}
+/**
+ * 将原始内容数据转换为 CardItemData 格式
+ */
+declare function transformContentToCardItem(rawData: RawContentData, cornerMode?: CardCornerMode): CardItemData;
+/**
+ * 将原始内容数据数组转换为 CardItemData 数组
+ */
+declare function transformContentListToCardItems(rawDataList: RawContentData[], cornerMode?: CardCornerMode): CardItemData[];
+//#endregion
+export { CardCornerMode, RawContentData, transformContentListToCardItems, transformContentToCardItem };

package/dist/components/biz/utils/transformers/card-grid.mjs

@@ -0,0 +1,2 @@
+
+function e(e){if(!e||e<=0)return``;let t=Math.floor(e),n=Math.floor(t/3600),r=Math.floor(t%3600/60),i=t%60,a=e=>String(e).padStart(2,`0`);return n>0?`${a(n)}:${a(r)}:${a(i)}`:`${a(r)}:${a(i)}`}function t(e){return e<1e3?e.toString():e<1e4?`${(e/1e3).toFixed(1)}k`:e<1e5?`${(e/1e4).toFixed(1)}w`:`${Math.floor(e/1e4)}w`}function n(n,r=`view-duration`){let i={},a=n.update_status===`1`,o=n.type;return r===`view-duration`?(i.leftBottom={type:`viewCount`,value:t(n.static.browse_cnt)},o===1&&n.duration?i.rightBottom={type:`episodeCount`,value:e(n.duration)}:o===2&&(i.rightBottom={type:`episodeCount`,value:a?`${n.episode_cnt}集全`:`更新至${n.episode_cnt}集`})):r===`category-score`&&(i.leftBottom={type:`category`,value:o===1?`电影`:`剧集`},i.rightBottom={type:`score`,value:n.score}),{id:n.id,title:n.name,cover:{vertical:n.img_y,horizontal:n.img_x},corners:i,type:o}}function r(e,t=`view-duration`){return e.map(e=>n(e,t))}export{r as transformContentListToCardItems,n as transformContentToCardItem};