@lingxiao-office/sdk 1.0.0

package/dist/core/DesignAssetCatalog.d.ts

@@ -0,0 +1,180 @@
+/**
+ * DesignAssetCatalog — 前端设计素材市场的数据引擎
+ *
+ * 目标:
+ * - Web 市场和 design_asset 工具共享同一套目录加载、字段归一和排序逻辑
+ * - 允许旧素材继续工作，同时把缺失描述、粗糙提示词和未分级资产提升到稳定格式
+ * - 查询结果优先返回更完整、更可落地、更有审美约束的素材
+ */
+export declare const ASSET_CATEGORIES: readonly ["button", "card", "background", "navigation", "form", "effect", "layout", "typography", "icon", "animation", "hero", "footer", "modal", "table", "badge"];
+export declare const ASSET_THEMES: readonly ["dark", "light", "glassmorphism", "neumorphism", "brutalist", "luxury", "minimal", "retro", "cyberpunk", "organic", "editorial", "gradient", "xianxia"];
+export declare const ASSET_TIERS: readonly ["signature", "production", "foundation"];
+export type AssetCategory = typeof ASSET_CATEGORIES[number];
+export type AssetTheme = typeof ASSET_THEMES[number];
+export type AssetTier = typeof ASSET_TIERS[number];
+export interface AssetQuality {
+    score: number;
+    tier: AssetTier;
+    complexity: 'drop-in' | 'component' | 'composition';
+    density: 'quiet' | 'balanced' | 'rich';
+}
+export interface AssetPreviewHints {
+    background: string;
+    minHeight: number;
+    surface: 'dark' | 'light' | 'transparent';
+}
+export interface DesignAsset {
+    id: string;
+    name: string;
+    category: AssetCategory;
+    themes: AssetTheme[];
+    tags: string[];
+    description: string;
+    /**
+     * 风格提示词 — 给 LLM 的精确描述，让模型能准确还原/扩展该素材的设计风格。
+     * 包含色彩方向、排版风格、动效思路、适用场景、禁忌和实现约束。
+     */
+    stylePrompt: string;
+    /** CSS 代码 */
+    css: string;
+    /** HTML 结构 (可选, 有的纯 CSS 素材不需要) */
+    html?: string;
+    /** React 组件代码 (可选) */
+    react?: string;
+    /** Tailwind 类名版本 (可选) */
+    tailwind?: string;
+    /** 设计说明 */
+    designNotes?: string;
+    /** 推荐场景 */
+    useCases?: string[];
+    /** 可访问性和工程落地提示 */
+    accessibility?: string[];
+    /** 可组合搭配的素材 ID 或 tag */
+    pairsWith?: string[];
+    /** 市场预览提示 */
+    preview?: AssetPreviewHints;
+    /** 策展质量信息 */
+    quality?: AssetQuality;
+    /** 来源文件，仅用于诊断和市场展示 */
+    source?: {
+        file: string;
+        index: number;
+    };
+}
+export interface AssetQuery {
+    category?: AssetCategory;
+    theme?: AssetTheme;
+    tags?: string[];
+    style?: string;
+    search?: string;
+    tier?: AssetTier;
+    limit?: number;
+    format?: 'css' | 'html' | 'react' | 'tailwind';
+}
+export interface AssetQueryResult {
+    total: number;
+    returned: number;
+    assets: DesignAsset[];
+    query: AssetQuery;
+}
+export interface DesignTheme {
+    id: AssetTheme;
+    name: string;
+    title: string;
+    description: string;
+    version?: string;
+    category?: string;
+    tags: string[];
+    palette: Record<string, string>;
+    previewHtml: string;
+    prompt: string;
+    previewFile: string;
+    promptFile: string;
+    source?: {
+        dir: string;
+        manifest: string;
+    };
+}
+export interface ThemeQuery {
+    theme?: string;
+    tags?: string[];
+    search?: string;
+    limit?: number;
+}
+export interface ThemeQueryResult {
+    total: number;
+    returned: number;
+    themeSites: DesignTheme[];
+    query: ThemeQuery;
+}
+export interface ThemeFacets {
+    themes: Array<{
+        theme: AssetTheme;
+        count: number;
+    }>;
+    tags: Array<{
+        tag: string;
+        count: number;
+    }>;
+}
+export declare function normalizeDesignAsset(rawAsset: unknown, sourceFile?: string, index?: number): DesignAsset | null;
+export declare function normalizeDesignAssets(rawAssets: unknown[], sourceFile?: string): DesignAsset[];
+export declare function sortDesignAssets(assets: DesignAsset[]): DesignAsset[];
+export declare function loadDesignAssetsFromDirectories(searchPaths: string[]): DesignAsset[];
+export declare function normalizeDesignTheme(rawManifest: unknown, themeDir: string): DesignTheme | null;
+export declare function loadDesignThemesFromDirectories(searchPaths: string[]): DesignTheme[];
+export declare class DesignThemeCatalog {
+    private themes;
+    private byId;
+    private byTag;
+    constructor(themes?: DesignTheme[]);
+    loadThemes(themes: DesignTheme[]): void;
+    private rebuildIndices;
+    get(id: AssetTheme): DesignTheme | undefined;
+    list(): DesignTheme[];
+    search(search: string, limit?: number): DesignTheme[];
+    getTags(): Array<{
+        tag: string;
+        count: number;
+    }>;
+    get size(): number;
+}
+export declare class DesignAssetCatalog {
+    private assets;
+    /** category -> assets 索引 */
+    private byCategory;
+    /** tag -> assets 索引 */
+    private byTag;
+    /** theme -> assets 索引 */
+    private byTheme;
+    constructor(assets?: DesignAsset[]);
+    loadAssets(assets: DesignAsset[]): void;
+    private rebuildIndices;
+    /**
+     * 查询素材库。category/theme/tags/tier 是 AND 过滤，search/style 是加权文本检索。
+     */
+    query(q: AssetQuery): AssetQueryResult;
+    /** 获取所有可用 category 及其素材数量 */
+    getCategories(): Array<{
+        category: AssetCategory;
+        count: number;
+    }>;
+    /** 获取所有可用 tag 及其素材数量 */
+    getTags(): Array<{
+        tag: string;
+        count: number;
+    }>;
+    /** 获取所有可用 theme 及其素材数量 */
+    getThemes(): Array<{
+        theme: AssetTheme;
+        count: number;
+    }>;
+    /** 获取所有可用质量分级及其数量 */
+    getTiers(): Array<{
+        tier: AssetTier;
+        count: number;
+    }>;
+    /** 素材总数 */
+    get size(): number;
+}
+//# sourceMappingURL=DesignAssetCatalog.d.ts.map

package/dist/core/DesignAssetCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesignAssetCatalog.d.ts","sourceRoot":"","sources":["../../src/core/DesignAssetCatalog.ts"],"names":[],"mappings":"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"}