@aithe/aithe-ui 26.2.2 → 26.3.1

package/dist/core/markdown/types.d.ts

@@ -0,0 +1,155 @@
+/**
+ * Markdown AST 节点类型定义
+ *
+ * 基于 AST（抽象语法树）的 Markdown 解析类型系统。
+ * 所有 Markdown 语法元素统一表示为树形节点，渲染器遍历 AST 输出 HTML。
+ */
+/** AST 节点基类 */
+export interface AstNode {
+    type: string;
+    children?: AstNode[];
+    [key: string]: unknown;
+}
+/** 文档根节点 */
+export interface DocumentNode extends AstNode {
+    type: 'document';
+    children: AstNode[];
+}
+/** 文本节点 */
+export interface TextNode extends AstNode {
+    type: 'text';
+    value: string;
+}
+/** 段落 */
+export interface ParagraphNode extends AstNode {
+    type: 'paragraph';
+    children: AstNode[];
+}
+/** 标题 */
+export interface HeadingNode extends AstNode {
+    type: 'heading';
+    level: number;
+    children: AstNode[];
+}
+/** 分隔线 */
+export interface ThematicBreakNode extends AstNode {
+    type: 'thematic-break';
+}
+/** 代码块 */
+export interface CodeBlockNode extends AstNode {
+    type: 'code-block';
+    lang: string;
+    value: string;
+}
+/** 行内代码 */
+export interface InlineCodeNode extends AstNode {
+    type: 'inline-code';
+    value: string;
+}
+/** 引用块 */
+export interface BlockquoteNode extends AstNode {
+    type: 'blockquote';
+    children: AstNode[];
+}
+/** 列表项 */
+export interface ListItemNode extends AstNode {
+    type: 'list-item';
+    checked: boolean | null;
+    children: AstNode[];
+}
+/** 列表 */
+export interface ListNode extends AstNode {
+    type: 'list';
+    ordered: boolean;
+    start: number;
+    children: ListItemNode[];
+}
+/** 表格 */
+export interface TableNode extends AstNode {
+    type: 'table';
+    header: TableRowNode;
+    align: string[];
+    body: TableRowNode[];
+}
+/** 表格行 */
+export interface TableRowNode extends AstNode {
+    type: 'table-row';
+    children: AstNode[];
+}
+/** 表格单元格 */
+export interface TableCellNode extends AstNode {
+    type: 'table-cell';
+    children: AstNode[];
+}
+/** 加粗 */
+export interface BoldNode extends AstNode {
+    type: 'bold';
+    children: AstNode[];
+}
+/** 斜体 */
+export interface ItalicNode extends AstNode {
+    type: 'italic';
+    children: AstNode[];
+}
+/** 删除线 */
+export interface StrikethroughNode extends AstNode {
+    type: 'strikethrough';
+    children: AstNode[];
+}
+/** 链接 */
+export interface LinkNode extends AstNode {
+    type: 'link';
+    url: string;
+    text: string;
+    children: AstNode[];
+}
+/** 图片 */
+export interface ImageNode extends AstNode {
+    type: 'image';
+    url: string;
+    alt: string;
+}
+/** Emoji */
+export interface EmojiNode extends AstNode {
+    type: 'emoji';
+    name: string;
+    unicode: string;
+}
+/** 图标 */
+export interface IconNode extends AstNode {
+    type: 'icon';
+    name: string;
+}
+/** 换行 */
+export interface LineBreakNode extends AstNode {
+    type: 'line-break';
+}
+/** 原始 HTML（安全白名单） */
+export interface RawHtmlNode extends AstNode {
+    type: 'raw-html';
+    value: string;
+}
+/** 原始行内文本（需要进一步行内解析） */
+export interface RawInlineNode extends AstNode {
+    type: 'raw-inline';
+    value: string;
+}
+/** 链接处理 hook */
+export type MarkdownLinkHook = (url: string, text: string) => string | undefined | null;
+/** 块级解析器：接收行数组，返回块级节点列表 */
+export type BlockParser = (lines: string[]) => {
+    nodes: AstNode[];
+    consumed: number;
+} | null;
+/** 行内解析器：接收文本，返回行内节点列表 */
+export type InlineParser = (text: string) => {
+    nodes: AstNode[];
+    consumed: number;
+} | null;
+/** AST 插件 */
+export interface AstPlugin {
+    name: string;
+    block?: BlockParser;
+    inline?: InlineParser;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/markdown/types.d.ts.map

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

package/dist/core/markdown/types.js

@@ -0,0 +1,7 @@
+/**
+ * Markdown AST 节点类型定义
+ *
+ * 基于 AST（抽象语法树）的 Markdown 解析类型系统。
+ * 所有 Markdown 语法元素统一表示为树形节点，渲染器遍历 AST 输出 HTML。
+ */
+export {};

package/dist/core/router/index.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Aithe UI 路由核心模块
+ * Core routing module for Aithe UI.
+ *
+ * 提供轻量、无第三方依赖的前端路由，适配 Lit 组件模型与响应式更新机制。
+ * Provides a lightweight, zero-dependency frontend router compatible with Lit's reactive model.
+ *
+ * 支持 hash 模式和 history 模式，静态路由、动态路由、通配符、查询参数解析、路由守卫。
+ * Supports hash and history modes, static routes, dynamic routes, wildcards, query parsing, and route guards.
+ *
+ * @module router
+ */
+/** 路由模式 / Routing mode */
+export type RouterMode = 'hash' | 'history';
+/** 路由守卫函数，返回 false 阻止导航 / Route guard function; return false to block navigation */
+export type RouteGuard = (to: RouteLocation, from: RouteLocation | null) => boolean | Promise<boolean>;
+/** 路由变更监听器 / Route change listener */
+export type RouteChangeListener = (location: RouteLocation) => void;
+/** 解析后的路由位置信息 / Resolved route location */
+export interface RouteLocation {
+    /** 完整路径（不含查询参数和 hash）/ Full path without query string and hash */
+    path: string;
+    /** 路径参数 / Path parameters (e.g. { id: '42' } for /user/:id) */
+    params: Record<string, string>;
+    /** 查询参数 / Query parameters (e.g. { a: '1', b: '2' } for ?a=1&b=2) */
+    query: Record<string, string>;
+    /** 匹配到的路由配置 / Matched route config */
+    route: RouteConfig | null;
+    /** 完整 URL（含查询参数）/ Full URL including query string */
+    fullPath: string;
+}
+/** 路由配置 / Route configuration */
+export interface RouteConfig {
+    /** 路径模式，支持静态 /home、动态 /user/:id、通配符 * / Path pattern: static /home, dynamic /user/:id, wildcard * */
+    path: string;
+    /** 匹配时渲染的组件标签名 / Component tag name to render when matched */
+    component: string;
+    /** 路由元数据，可存放 title、auth 等自定义字段 / Route metadata for custom fields like title, auth */
+    meta?: Record<string, unknown>;
+    /** 子路由（嵌套路由）/ Child routes for nested routing */
+    children?: RouteConfig[];
+}
+/**
+ * 路由核心类，管理路由注册、匹配、导航和监听。
+ * Core Router class that manages route registration, matching, navigation, and listeners.
+ *
+ * @example
+ * ```ts
+ * const router = new Router({
+ *   mode: 'history',
+ *   routes: [
+ *     { path: '/', component: 'home-page' },
+ *     { path: '/user/:id', component: 'user-page' },
+ *     { path: '*', component: 'not-found-page' },
+ *   ],
+ * });
+ * router.start();
+ * ```
+ */
+export declare class Router {
+    private readonly mode;
+    private readonly routes;
+    private compiled;
+    private readonly listeners;
+    private readonly guards;
+    private _currentLocation;
+    private _started;
+    constructor(options: {
+        mode?: RouterMode;
+        routes: RouteConfig[];
+    });
+    /** 当前路由位置 / Current route location */
+    get currentLocation(): RouteLocation | null;
+    /** 路由是否已启动 / Whether the router has been started */
+    get started(): boolean;
+    /** 添加路由配置 / Add route configurations */
+    addRoutes(routes: RouteConfig[]): void;
+    /** 注册路由守卫 / Register a route guard */
+    addGuard(guard: RouteGuard): () => void;
+    /** 订阅路由变更 / Subscribe to route changes */
+    onChange(listener: RouteChangeListener): () => void;
+    /**
+     * 启动路由监听 / Start listening for route changes.
+     * 在 hash 模式下监听 hashchange，在 history 模式下监听 popstate。
+     */
+    start(): void;
+    /** 停止路由监听 / Stop listening for route changes */
+    stop(): void;
+    /**
+     * 编程式导航 / Programmatic navigation.
+     * 在 history 模式下使用 pushState，在 hash 模式下修改 location.hash。
+     */
+    navigate(path: string): Promise<void>;
+    /** 替换当前历史记录并导航 / Replace current history entry and navigate */
+    replace(path: string): Promise<void>;
+    /** 后退 / Go back in history */
+    back(): void;
+    /** 前进 / Go forward in history */
+    forward(): void;
+    /**
+     * 匹配路径，返回 RouteLocation（不触发导航）
+     * Match a path and return RouteLocation without triggering navigation.
+     */
+    match(path: string): RouteLocation;
+    /** 获取当前浏览器路径 / Get current browser path */
+    getCurrentBrowserPath(): string;
+    private compileRoutes;
+    private readonly handleRouteChange;
+    private resolve;
+    private runGuards;
+    private splitPathQuery;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/core/router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/router/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,0BAA0B;AAC1B,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5C,oFAAoF;AACpF,MAAM,MAAM,UAAU,GAAG,CACvB,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,aAAa,GAAG,IAAI,KACvB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC,sCAAsC;AACtC,MAAM,MAAM,mBAAmB,GAAG,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;AAEpE,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,sCAAsC;IACtC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,iCAAiC;AACjC,MAAM,WAAW,WAAW;IAC1B,qGAAqG;IACrG,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B;AA2CD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,WAAW,EAAE,CAAA;KAAE;IAMjE,sCAAsC;IACtC,IAAI,eAAe,IAAI,aAAa,GAAG,IAAI,CAE1C;IAED,oDAAoD;IACpD,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,wCAAwC;IACxC,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI;IAKtC,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,IAAI;IAQvC,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI;IAQnD;;;OAGG;IACH,KAAK,IAAI,IAAI;IAab,gDAAgD;IAChD,IAAI,IAAI,IAAI;IAWZ;;;OAGG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB3C,+DAA+D;IACzD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe1C,8BAA8B;IAC9B,IAAI,IAAI,IAAI;IAIZ,iCAAiC;IACjC,OAAO,IAAI,IAAI;IAIf;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa;IA6BlC,2CAA2C;IAC3C,qBAAqB,IAAI,MAAM;IAQ/B,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAEhC;IAEF,OAAO,CAAC,OAAO;YASD,SAAS;IAQvB,OAAO,CAAC,cAAc;CAKvB"}

package/dist/core/router/index.js

@@ -0,0 +1,244 @@
+/**
+ * Aithe UI 路由核心模块
+ * Core routing module for Aithe UI.
+ *
+ * 提供轻量、无第三方依赖的前端路由，适配 Lit 组件模型与响应式更新机制。
+ * Provides a lightweight, zero-dependency frontend router compatible with Lit's reactive model.
+ *
+ * 支持 hash 模式和 history 模式，静态路由、动态路由、通配符、查询参数解析、路由守卫。
+ * Supports hash and history modes, static routes, dynamic routes, wildcards, query parsing, and route guards.
+ *
+ * @module router
+ */
+/**
+ * 将路由路径模式编译为正则表达式
+ * Compile a route path pattern into a regular expression.
+ */
+function compilePattern(pattern) {
+    const paramNames = [];
+    if (pattern === '*') {
+        return { regex: /^.*$/, paramNames };
+    }
+    const regexStr = pattern
+        .replaceAll('/', String.raw `\/`)
+        .replaceAll(/:([a-zA-Z_]\w*)/g, (_match, name) => {
+        paramNames.push(name);
+        return '([^/]+)';
+    });
+    return { regex: new RegExp(`^${regexStr}$`), paramNames };
+}
+/**
+ * 解析查询字符串为键值对
+ * Parse a query string into key-value pairs.
+ */
+function parseQuery(queryStr) {
+    const query = {};
+    if (!queryStr)
+        return query;
+    const params = new URLSearchParams(queryStr);
+    for (const [key, value] of params) {
+        query[key] = value;
+    }
+    return query;
+}
+/**
+ * 路由核心类，管理路由注册、匹配、导航和监听。
+ * Core Router class that manages route registration, matching, navigation, and listeners.
+ *
+ * @example
+ * ```ts
+ * const router = new Router({
+ *   mode: 'history',
+ *   routes: [
+ *     { path: '/', component: 'home-page' },
+ *     { path: '/user/:id', component: 'user-page' },
+ *     { path: '*', component: 'not-found-page' },
+ *   ],
+ * });
+ * router.start();
+ * ```
+ */
+export class Router {
+    constructor(options) {
+        this.compiled = [];
+        this.listeners = new Set();
+        this.guards = [];
+        this._currentLocation = null;
+        this._started = false;
+        this.handleRouteChange = () => {
+            this.resolve();
+        };
+        this.mode = options.mode ?? 'history';
+        this.routes = options.routes;
+        this.compileRoutes();
+    }
+    /** 当前路由位置 / Current route location */
+    get currentLocation() {
+        return this._currentLocation;
+    }
+    /** 路由是否已启动 / Whether the router has been started */
+    get started() {
+        return this._started;
+    }
+    /** 添加路由配置 / Add route configurations */
+    addRoutes(routes) {
+        this.routes.push(...routes);
+        this.compileRoutes();
+    }
+    /** 注册路由守卫 / Register a route guard */
+    addGuard(guard) {
+        this.guards.push(guard);
+        return () => {
+            const idx = this.guards.indexOf(guard);
+            if (idx > -1)
+                this.guards.splice(idx, 1);
+        };
+    }
+    /** 订阅路由变更 / Subscribe to route changes */
+    onChange(listener) {
+        this.listeners.add(listener);
+        if (this._currentLocation) {
+            listener(this._currentLocation);
+        }
+        return () => this.listeners.delete(listener);
+    }
+    /**
+     * 启动路由监听 / Start listening for route changes.
+     * 在 hash 模式下监听 hashchange，在 history 模式下监听 popstate。
+     */
+    start() {
+        if (this._started)
+            return;
+        this._started = true;
+        if (this.mode === 'hash') {
+            globalThis.addEventListener('hashchange', this.handleRouteChange);
+        }
+        else {
+            globalThis.addEventListener('popstate', this.handleRouteChange);
+        }
+        this.resolve();
+    }
+    /** 停止路由监听 / Stop listening for route changes */
+    stop() {
+        if (!this._started)
+            return;
+        this._started = false;
+        if (this.mode === 'hash') {
+            globalThis.removeEventListener('hashchange', this.handleRouteChange);
+        }
+        else {
+            globalThis.removeEventListener('popstate', this.handleRouteChange);
+        }
+    }
+    /**
+     * 编程式导航 / Programmatic navigation.
+     * 在 history 模式下使用 pushState，在 hash 模式下修改 location.hash。
+     */
+    async navigate(path) {
+        const targetPath = path;
+        const currentPath = this.getCurrentBrowserPath();
+        if (targetPath === currentPath)
+            return;
+        const from = this._currentLocation;
+        const to = this.match(targetPath);
+        const allowed = await this.runGuards(to, from);
+        if (!allowed)
+            return;
+        if (this.mode === 'hash') {
+            globalThis.location.hash = targetPath;
+        }
+        else {
+            globalThis.history.pushState({}, '', targetPath);
+            this.resolve();
+        }
+    }
+    /** 替换当前历史记录并导航 / Replace current history entry and navigate */
+    async replace(path) {
+        const from = this._currentLocation;
+        const to = this.match(path);
+        const allowed = await this.runGuards(to, from);
+        if (!allowed)
+            return;
+        if (this.mode === 'hash') {
+            globalThis.location.replace(`#${path}`);
+        }
+        else {
+            globalThis.history.replaceState({}, '', path);
+            this.resolve();
+        }
+    }
+    /** 后退 / Go back in history */
+    back() {
+        globalThis.history.back();
+    }
+    /** 前进 / Go forward in history */
+    forward() {
+        globalThis.history.forward();
+    }
+    /**
+     * 匹配路径，返回 RouteLocation（不触发导航）
+     * Match a path and return RouteLocation without triggering navigation.
+     */
+    match(path) {
+        const [pathOnly, queryStr] = this.splitPathQuery(path);
+        for (const compiled of this.compiled) {
+            const match = compiled.regex.exec(pathOnly);
+            if (match) {
+                const params = {};
+                for (const [i, name] of compiled.paramNames.entries()) {
+                    params[name] = match[i + 1];
+                }
+                return {
+                    path: pathOnly,
+                    params,
+                    query: parseQuery(queryStr),
+                    route: compiled.route,
+                    fullPath: path,
+                };
+            }
+        }
+        return {
+            path: pathOnly,
+            params: {},
+            query: parseQuery(queryStr),
+            route: null,
+            fullPath: path,
+        };
+    }
+    /** 获取当前浏览器路径 / Get current browser path */
+    getCurrentBrowserPath() {
+        if (this.mode === 'hash') {
+            const hash = globalThis.location.hash.slice(1) || '/';
+            return hash;
+        }
+        return globalThis.location.pathname + globalThis.location.search || '/';
+    }
+    compileRoutes() {
+        this.compiled = this.routes.map((route) => {
+            const { regex, paramNames } = compilePattern(route.path);
+            return { route, regex, paramNames };
+        });
+    }
+    resolve() {
+        const path = this.getCurrentBrowserPath();
+        const location = this.match(path);
+        this._currentLocation = location;
+        for (const fn of this.listeners) {
+            fn(location);
+        }
+    }
+    async runGuards(to, from) {
+        for (const guard of this.guards) {
+            const result = await guard(to, from);
+            if (result === false)
+                return false;
+        }
+        return true;
+    }
+    splitPathQuery(path) {
+        const qIdx = path.indexOf('?');
+        if (qIdx === -1)
+            return [path, ''];
+        return [path.slice(0, qIdx), path.slice(qIdx + 1)];
+    }
+}

package/dist/core/styles.d.ts

@@ -1,8 +1,17 @@
-import { aitheGlobalCssText } from '../styles/global.css';
+/** Base styles shared by every Aithe component (reset + primitive tokens). 所有 Aithe 组件共享的基础样式（重置 + 基础令牌）。 */
 export declare const aitheBaseStyles: import("lit").CSSResult[];
+/**
+ * Generate panel surface styles for a given CSS selector.
+ * 为给定 CSS 选择器生成面板表面样式。
+ *
+ * @param selector - CSS selector to target. Defaults to `.panel`. 目标 CSS 选择器，默认为 `.panel`。
+ * @returns A Lit `CSSResult` with surface background and border styles. 包含表面背景和边框样式的 Lit `CSSResult`。
+ */
 export declare const aithePanelStyles: (selector?: string) => import("lit").CSSResult;
+/** Reusable control (input-like) base styles. 可复用的控件（输入类）基础样式。 */
 export declare const aitheControlStyleBlock: import("lit").CSSResult;
+/** Focus ring styles for controls. 控件的聚焦环样式。 */
 export declare const aitheControlFocusStyleBlock: import("lit").CSSResult;
+/** Cross-browser thin scrollbar styles. 跨浏览器细滚动条样式。 */
 export declare const aitheScrollbarStyles: import("lit").CSSResult;
-export { aitheGlobalCssText };
 //# sourceMappingURL=styles.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/core/styles.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGlF,eAAO,MAAM,eAAe,2BAAiD,CAAC;AAE9E,eAAO,MAAM,gBAAgB,GAAI,iBAAmB,4BAInD,CAAC;AAEF,eAAO,MAAM,sBAAsB,yBAElC,CAAC;AAEF,eAAO,MAAM,2BAA2B,yBAEvC,CAAC;AAEF,eAAO,MAAM,oBAAoB,yBAiBhC,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/core/styles.ts"],"names":[],"mappings":"AAUA,6GAA6G;AAC7G,eAAO,MAAM,eAAe,2BAAiD,CAAC;AAE9E;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,iBAAmB,4BAInD,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,sBAAsB,yBAElC,CAAC;AAEF,gDAAgD;AAChD,eAAO,MAAM,2BAA2B,yBAEvC,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,yBAiBhC,CAAC"}

package/dist/core/styles.js

@@ -0,0 +1,44 @@
+import { css, unsafeCSS } from 'lit';
+import { aitheGlobalResetStyles } from '../styles/global.css';
+import { aitheControlFocusStyles, aitheControlStyles, aithePrimitiveTokens, aitheSurfaceStyles, } from '../styles/mixins';
+/** Base styles shared by every Aithe component (reset + primitive tokens). 所有 Aithe 组件共享的基础样式（重置 + 基础令牌）。 */
+export const aitheBaseStyles = [aithePrimitiveTokens, aitheGlobalResetStyles];
+/**
+ * Generate panel surface styles for a given CSS selector.
+ * 为给定 CSS 选择器生成面板表面样式。
+ *
+ * @param selector - CSS selector to target. Defaults to `.panel`. 目标 CSS 选择器，默认为 `.panel`。
+ * @returns A Lit `CSSResult` with surface background and border styles. 包含表面背景和边框样式的 Lit `CSSResult`。
+ */
+export const aithePanelStyles = (selector = '.panel') => css `
+  ${unsafeCSS(selector)} {
+    ${aitheSurfaceStyles}
+  }
+`;
+/** Reusable control (input-like) base styles. 可复用的控件（输入类）基础样式。 */
+export const aitheControlStyleBlock = css `
+  ${aitheControlStyles}
+`;
+/** Focus ring styles for controls. 控件的聚焦环样式。 */
+export const aitheControlFocusStyleBlock = css `
+  ${aitheControlFocusStyles}
+`;
+/** Cross-browser thin scrollbar styles. 跨浏览器细滚动条样式。 */
+export const aitheScrollbarStyles = css `
+  * {
+    scrollbar-color: var(--aithe-neutral-5) transparent;
+    scrollbar-width: thin;
+  }
+
+  *::-webkit-scrollbar {
+    width: 10px;
+    height: 10px;
+  }
+
+  *::-webkit-scrollbar-thumb {
+    background: rgba(130, 145, 171, 0.42);
+    border: 2px solid transparent;
+    border-radius: 999px;
+    background-clip: padding-box;
+  }
+`;