@agentskillmania/skill-ui-shared 0.1.4 → 1.0.0

package/README.md

@@ -1,6 +1,6 @@
 # @agentskillmania/skill-ui-shared
 
-Shared UI components, hooks, and style presets for the @agentskillmania skill-ui ecosystem.
+Shared foundation for @agentskillmania skill-ui packages — organized by faces, every member has real consumers.
 
 ## Installation
 
@@ -8,44 +8,39 @@ Shared UI components, hooks, and style presets for the @agentskillmania skill-ui
 pnpm add @agentskillmania/skill-ui-shared
 ```
 
-## Components
+## Faces
 
-| Component | Description |
-|-----------|-------------|
-| `Sidebar` | Right-side collapsible sidebar shell |
-| `SidebarPanel` | Panel container with title bar + scrollable body |
-| `SidebarIcons` | Vertical icon bar for panel switching |
-| `CollapsibleCard` | antd Card (size="small") with collapse toggle |
-| `SectionHeader` | Icon + uppercase label + bottom divider |
-| `EmptyState` | Placeholder based on antd Empty |
-| `ExpandableItem` | Headless expandable list item container |
-| `SplitDivider` | 4px draggable vertical divider |
+### files — file browsing domain
 
-## Hooks
+File tree / tabs / preview / type classification shared by the editor workbench and host side panels.
 
-| Hook | Description |
-|------|-------------|
-| `useToggle` | Boolean state with set/toggle/reset |
-| `useResize` | Drag-based width resizing |
+| Export | Description |
+|---|---|
+| `FileTree` | File tree with directory expand/collapse and single selection |
+| `FileTabs` | File tabs with dirty indicator and close button |
+| `FilePreview` | Read-only preview — markdown rendered via `@ant-design/x-markdown`, code/text as `<pre>` |
+| `FileTypeIcon` | Extension-driven lucide icon (markdown/code/image/doc/file) |
+| `getFileKind` | Behavior classification: `'code' \| 'markdown' \| 'image' \| 'file'` |
+| `getFileLabel` | Basename of a path |
+| `FileNode` / `FileTab` / `FileTreeProps` / `FileTabsProps` / `FilePreviewProps` | Types |
 
-## Style Presets
+### display
 
-| Preset | Description |
-|--------|-------------|
-| `cardBodyTransition` | Card body collapse/expand animation |
-| `cardHeaderInteractive` | Card header cursor + hover styles |
-| `expandableDetailTransition` | Expandable detail area animation |
-| `expandableSummaryHover` | Summary row hover styles |
+| Export | Description |
+|---|---|
+| `EmptyState` | Empty placeholder based on antd Empty |
+
+### utils
+
+| Export | Description |
+|---|---|
+| `formatTokens` | Compact token counts — `1200 → "1.2k"`, `1500000 → "1.5M"` |
+| `formatDuration` | Milliseconds — `1500 → "1.5s"`, `42 → "42ms"` |
 
 ## i18n
 
-Exports `NAMESPACE` (`skill-ui-shared`) and `resources` for zh-CN / en-US locales.
+`NAMESPACE` / `resources` are exported for host registration (zh-CN / en-US).
 
-## Peer Dependencies
+## License
 
-- `@agentskillmania/skill-ui-theme`
-- `react`, `react-dom`
-- `antd` (^6.0.0)
-- `lucide-react`
-- `@emotion/react`
-- `react-i18next`
+MIT © [yusangeng](https://github.com/yusangeng)

package/README.zh_CN.md

@@ -0,0 +1,46 @@
+# @agentskillmania/skill-ui-shared
+
+@agentskillmania skill-ui 生态的共享基础层 —— 按"面"组织，每个成员都有真实消费者。
+
+## 安装
+
+```bash
+pnpm add @agentskillmania/skill-ui-shared
+```
+
+## 面
+
+### files — 文件浏览域
+
+编辑器工作台与宿主边窗共用的文件树 / 页签 / 预览 / 类型分类。
+
+| 导出 | 说明 |
+|---|---|
+| `FileTree` | 文件树（目录展开/折叠 + 单选） |
+| `FileTabs` | 文件页签（未保存标记 + 关闭按钮） |
+| `FilePreview` | 只读预览 —— markdown 经 `@ant-design/x-markdown` 渲染，代码/文本为 `<pre>` |
+| `FileTypeIcon` | 扩展名驱动的 lucide 图标（markdown/code/image/doc/file） |
+| `getFileKind` | 行为分类：`'code' \| 'markdown' \| 'image' \| 'file'` |
+| `getFileLabel` | 路径最后一段 |
+| `FileNode` / `FileTab` / `FileTreeProps` / `FileTabsProps` / `FilePreviewProps` | 类型 |
+
+### display
+
+| 导出 | 说明 |
+|---|---|
+| `EmptyState` | 基于 antd Empty 的空态占位 |
+
+### utils
+
+| 导出 | 说明 |
+|---|---|
+| `formatTokens` | 紧凑 token 计数 —— `1200 → "1.2k"`，`1500000 → "1.5M"` |
+| `formatDuration` | 毫秒时长 —— `1500 → "1.5s"`，`42 → "42ms"` |
+
+## i18n
+
+导出 `NAMESPACE` / `resources` 供宿主注册（zh-CN / en-US）。
+
+## License
+
+MIT © [yusangeng](https://github.com/yusangeng)

package/dist/files/FilePreview.d.ts

@@ -0,0 +1,4 @@
+import type { FilePreviewProps } from './types.js';
+/** 只读文件内容预览：markdown 渲染 / 文本原样展示。 */
+export declare function FilePreview({ path, content, className, style }: FilePreviewProps): import("@emotion/react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=FilePreview.d.ts.map

package/dist/files/FilePreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilePreview.d.ts","sourceRoot":"","sources":["../../src/files/FilePreview.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAKnD,qCAAqC;AACrC,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,gBAAgB,oDAkDhF"}

package/dist/files/FilePreview.js

@@ -0,0 +1,50 @@
+import { jsx as _jsx } from "@emotion/react/jsx-runtime";
+/** @jsxImportSource @emotion/react */
+/**
+ * 只读文件预览器 — files 域通用件。
+ *
+ * 按 FileKind 路由：
+ * - markdown → @ant-design/x-markdown 静态渲染
+ * - code / file → 只读 <pre> 文本
+ *
+ * image（二进制）不进此组件 — 预览通道由宿主决定（如 antd Image / 静态 URL）。
+ * streaming 光标/防闪烁高亮属于聊天语义，这里不需要。
+ */
+import { useTheme } from '@agentskillmania/skill-ui-theme';
+import _XMarkdown from '@ant-design/x-markdown';
+import { css } from '@emotion/react';
+import { getFileKind } from './file-extensions.js';
+// React 19 type compatibility: XMarkdown declared as FC but TS cannot recognize it as JSX component
+const XMarkdown = _XMarkdown;
+/** 只读文件内容预览：markdown 渲染 / 文本原样展示。 */
+export function FilePreview({ path, content, className, style }) {
+    const theme = useTheme();
+    const kind = getFileKind(path);
+    if (kind === 'markdown') {
+        return (_jsx("div", { className: className, style: style, css: css `
+          height: 100%;
+          overflow-y: auto;
+          padding: ${theme.spacing[3]};
+          color: ${theme.color.text};
+          font-size: ${theme.font.size.sm};
+          line-height: 1.7;
+        `, children: _jsx(XMarkdown, { content: content, openLinksInNewTab: true, 
+                // escape raw HTML in markdown as plain text to prevent XSS —
+                // previewed content may come from untrusted workspaces.
+                escapeRawHtml: true }) }));
+    }
+    return (_jsx("pre", { className: className, style: style, css: css `
+        margin: 0;
+        height: 100%;
+        overflow: auto;
+        padding: ${theme.spacing[3]};
+        background: ${theme.color.bgContainer};
+        color: ${theme.color.text};
+        font-family: ${theme.font.familyMono};
+        font-size: ${theme.font.size.sm};
+        line-height: 1.6;
+        white-space: pre-wrap;
+        word-break: break-word;
+      `, children: content }));
+}
+//# sourceMappingURL=FilePreview.js.map

package/dist/files/FilePreview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilePreview.js","sourceRoot":"","sources":["../../src/files/FilePreview.tsx"],"names":[],"mappings":";AAAA,sCAAsC;AACtC;;;;;;;;;GASG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,UAAU,MAAM,wBAAwB,CAAC;AAEhD,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAGrC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD,oGAAoG;AACpG,MAAM,SAAS,GAAG,UAA4D,CAAC;AAE/E,qCAAqC;AACrC,MAAM,UAAU,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAoB;IAC/E,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAE/B,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,OAAO,CACL,cACE,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,GAAG,CAAA;;;qBAGK,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;mBAClB,KAAK,CAAC,KAAK,CAAC,IAAI;uBACZ,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;;SAEhC,YAED,KAAC,SAAS,IACR,OAAO,EAAE,OAAO,EAChB,iBAAiB;gBACjB,6DAA6D;gBAC7D,wDAAwD;gBACxD,aAAa,SACb,GACE,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,cACE,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,GAAG,CAAA;;;;mBAIK,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;sBACb,KAAK,CAAC,KAAK,CAAC,WAAW;iBAC5B,KAAK,CAAC,KAAK,CAAC,IAAI;uBACV,KAAK,CAAC,IAAI,CAAC,UAAU;qBACvB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;;;;OAIhC,YAEA,OAAO,GACJ,CACP,CAAC;AACJ,CAAC"}

package/dist/files/FileTabs.d.ts

@@ -0,0 +1,3 @@
+import type { FileTabsProps } from './types.js';
+export declare function FileTabs({ tabs, activePath, onTabChange, onTabClose }: FileTabsProps): import("@emotion/react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=FileTabs.d.ts.map

package/dist/files/FileTabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileTabs.d.ts","sourceRoot":"","sources":["../../src/files/FileTabs.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAW,MAAM,YAAY,CAAC;AA8GzD,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,aAAa,oDA0BpF"}

package/dist/files/FileTabs.js

@@ -0,0 +1,88 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@emotion/react/jsx-runtime";
+/** @jsxImportSource @emotion/react */
+/**
+ * 文件页签组件 — 文件浏览域通用件（弹性收缩、未保存标记、关闭按钮）。
+ */
+import { useTheme, interactiveItem, borderSeparator } from '@agentskillmania/skill-ui-theme';
+import { css } from '@emotion/react';
+import { X } from 'lucide-react';
+import { useTranslation } from 'react-i18next';
+import { FileTypeIcon } from './FileTypeIcon.js';
+import { NAMESPACE } from '../locales/index.js';
+/** Single tab */
+function TabItem({ tab, isActive, onClick, onClose, }) {
+    const theme = useTheme();
+    const { t } = useTranslation(NAMESPACE);
+    return (_jsxs("div", { onClick: () => onClick(tab.path), css: css `
+        display: flex;
+        align-items: center;
+        gap: ${theme.spacing[1]};
+        padding: ${theme.spacing[1]} ${theme.spacing[2]};
+        background: ${isActive ? theme.color.primaryBg : 'transparent'};
+        border-radius: ${theme.radius.sm};
+        cursor: pointer;
+        transition: all ${theme.motion.duration.fast} ${theme.motion.easing.out};
+        flex: 1;
+        min-width: 0;
+        max-width: 180px;
+        flex-shrink: 1;
+        overflow: hidden;
+
+        ${interactiveItem(theme, theme.color.primaryBg)}
+        &:hover button {
+          opacity: 0.6;
+        }
+      `, children: [_jsx("span", { css: css `
+          display: flex;
+          align-items: center;
+          flex-shrink: 0;
+          color: ${isActive ? theme.color.primary : theme.color.textTertiary};
+        `, children: _jsx(FileTypeIcon, { path: tab.label, size: 12 }) }), _jsxs("span", { css: css `
+          flex: 1;
+          min-width: 0;
+          font-size: ${theme.font.size.sm};
+          color: ${isActive ? theme.color.text : theme.color.textSecondary};
+          white-space: nowrap;
+          overflow: hidden;
+          text-overflow: ellipsis;
+        `, children: [tab.label, tab.modified && (_jsx("span", { css: css `
+              color: ${theme.color.primary};
+              margin-left: 2px;
+            `, children: "\u2022" }))] }), _jsx("button", { onClick: (e) => {
+                    e.stopPropagation();
+                    onClose(tab.path);
+                }, css: css `
+          width: 20px;
+          height: 20px;
+          display: flex;
+          align-items: center;
+          justify-content: center;
+          border: none;
+          background: transparent;
+          border-radius: ${theme.radius.xs};
+          cursor: pointer;
+          color: ${theme.color.textTertiary};
+          opacity: ${isActive ? 0.7 : 0};
+          flex-shrink: 0;
+          transition: all ${theme.motion.duration.fast};
+
+          &:hover {
+            background: ${theme.color.fill};
+            color: ${theme.color.text};
+            opacity: 1;
+          }
+        `, type: "button", "aria-label": t('fileTabs.close', { label: tab.label }), children: _jsx(X, { size: 12 }) })] }));
+}
+export function FileTabs({ tabs, activePath, onTabChange, onTabClose }) {
+    const theme = useTheme();
+    return (_jsx("div", { css: css `
+        display: flex;
+        align-items: center;
+        gap: ${theme.spacing['0.5']};
+        min-width: 0;
+        overflow: hidden;
+        padding: ${theme.spacing['0.5']} ${theme.spacing[1]};
+        ${borderSeparator(theme)}
+      `, children: tabs.map((tab) => (_jsx(TabItem, { tab: tab, isActive: tab.path === activePath, onClick: onTabChange, onClose: onTabClose }, tab.path))) }));
+}
+//# sourceMappingURL=FileTabs.js.map

package/dist/files/FileTabs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileTabs.js","sourceRoot":"","sources":["../../src/files/FileTabs.tsx"],"names":[],"mappings":"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"}

package/dist/files/FileTree.d.ts

@@ -0,0 +1,3 @@
+import type { FileTreeProps } from './types.js';
+export declare function FileTree({ files, activeFilePath, onSelect }: FileTreeProps): import("@emotion/react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=FileTree.d.ts.map

package/dist/files/FileTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileTree.d.ts","sourceRoot":"","sources":["../../src/files/FileTree.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAY,aAAa,EAAE,MAAM,YAAY,CAAC;AAiG1D,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE,aAAa,oDA2B1E"}

package/dist/files/FileTree.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@emotion/react/jsx-runtime";
+/** @jsxImportSource @emotion/react */
+/**
+ * 文件树组件 — 文件浏览域通用件（文件树 + 目录展开 + 单选）。
+ */
+import { useTheme, interactiveItem } from '@agentskillmania/skill-ui-theme';
+import { css } from '@emotion/react';
+import { ChevronRight, ChevronDown, FolderOpen } from 'lucide-react';
+import { useCallback, useState } from 'react';
+import { useTranslation } from 'react-i18next';
+import { FileTypeIcon } from './FileTypeIcon.js';
+import { EmptyState } from '../components/EmptyState.js';
+import { NAMESPACE } from '../locales/index.js';
+/** Single tree node */
+function TreeNode({ file, activeFilePath, depth, onSelect, }) {
+    const theme = useTheme();
+    const [expanded, setExpanded] = useState(true);
+    const isActive = file.path === activeFilePath;
+    const handleClick = useCallback(() => {
+        if (file.isDirectory) {
+            setExpanded((prev) => !prev);
+        }
+        else {
+            onSelect(file.path);
+        }
+    }, [file, onSelect]);
+    return (_jsxs("div", { children: [_jsxs("div", { onClick: handleClick, "data-active": isActive ? 'true' : undefined, css: css `
+          display: flex;
+          align-items: center;
+          gap: ${theme.spacing[1]};
+          padding: ${theme.spacing['0.5']} ${theme.spacing[1]};
+          padding-left: ${theme.spacing[1 + depth * 2]};
+          cursor: pointer;
+          border-radius: ${theme.radius.xs};
+          background: ${isActive ? theme.color.primaryBg : 'transparent'};
+          color: ${isActive ? theme.color.primary : theme.color.text};
+          font-size: ${theme.font.size.sm};
+          transition: background ${theme.motion.duration.fast};
+          ${interactiveItem(theme, isActive ? theme.color.primaryBg : theme.color.fillSubtle)}
+        `, children: [file.isDirectory && (_jsx("span", { css: css `
+              display: flex;
+              color: ${theme.color.textTertiary};
+            `, children: expanded ? _jsx(ChevronDown, { size: 14 }) : _jsx(ChevronRight, { size: 14 }) })), _jsx("span", { css: css `
+            display: flex;
+            color: ${theme.color.textTertiary};
+          `, children: file.isDirectory ? (_jsx(FolderOpen, { size: 14 })) : (_jsx(FileTypeIcon, { path: file.path, size: 14 })) }), _jsx("span", { css: css `
+            overflow: hidden;
+            text-overflow: ellipsis;
+            white-space: nowrap;
+          `, children: file.path.split('/').pop() })] }), file.isDirectory && expanded && file.children && (_jsx("div", { children: file.children.map((child) => (_jsx(TreeNode, { file: child, activeFilePath: activeFilePath, depth: depth + 1, onSelect: onSelect }, child.path))) }))] }));
+}
+export function FileTree({ files, activeFilePath, onSelect }) {
+    const theme = useTheme();
+    const { t } = useTranslation(NAMESPACE);
+    if (!files || files.length === 0) {
+        return _jsx(EmptyState, { description: t('fileTree.emptyHint') });
+    }
+    return (_jsx("div", { css: css `
+        height: 100%;
+        overflow-y: auto;
+        padding: ${theme.spacing[1]} 0;
+      `, children: files.map((file) => (_jsx(TreeNode, { file: file, activeFilePath: activeFilePath, depth: 0, onSelect: onSelect }, file.path))) }));
+}
+//# sourceMappingURL=FileTree.js.map

package/dist/files/FileTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileTree.js","sourceRoot":"","sources":["../../src/files/FileTree.tsx"],"names":[],"mappings":"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"}

package/dist/files/FileTypeIcon.d.ts

@@ -0,0 +1,4 @@
+import type { FileTypeIconProps } from './types.js';
+/** 按文件扩展名渲染对应图标。 */
+export declare function FileTypeIcon({ path, size }: FileTypeIconProps): import("react").FunctionComponentElement<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+//# sourceMappingURL=FileTypeIcon.d.ts.map

package/dist/files/FileTypeIcon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileTypeIcon.d.ts","sourceRoot":"","sources":["../../src/files/FileTypeIcon.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAWpD,oBAAoB;AACpB,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,IAAS,EAAE,EAAE,iBAAiB,4IAElE"}

package/dist/files/FileTypeIcon.js

@@ -0,0 +1,26 @@
+/**
+ * 文件类型图标 — files 域共用（FileTree/FileTabs/宿主列表）。
+ *
+ * 图标映射独立于 FileKind：markdown→FileText、纯文本文档→Book、
+ * code→FileCode、image→FileImage、其他→File。
+ */
+import { Book, File, FileCode, FileImage, FileText } from 'lucide-react';
+import { createElement } from 'react';
+import { getFileKind, isTextDoc } from './file-extensions.js';
+function iconFor(path) {
+    const kind = getFileKind(path);
+    if (kind === 'markdown')
+        return FileText;
+    if (kind === 'image')
+        return FileImage;
+    if (kind === 'code')
+        return FileCode;
+    if (isTextDoc(path))
+        return Book;
+    return File;
+}
+/** 按文件扩展名渲染对应图标。 */
+export function FileTypeIcon({ path, size = 14 }) {
+    return createElement(iconFor(path), { size });
+}
+//# sourceMappingURL=FileTypeIcon.js.map

package/dist/files/FileTypeIcon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileTypeIcon.js","sourceRoot":"","sources":["../../src/files/FileTypeIcon.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAmB,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAG9D,SAAS,OAAO,CAAC,IAAY;IAC3B,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,IAAI,KAAK,UAAU;QAAE,OAAO,QAAQ,CAAC;IACzC,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,SAAS,CAAC;IACvC,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,QAAQ,CAAC;IACrC,IAAI,SAAS,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACjC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oBAAoB;AACpB,MAAM,UAAU,YAAY,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,EAAqB;IACjE,OAAO,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;AAChD,CAAC"}

package/dist/files/file-extensions.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 文件扩展名分类 — files 域共用（FileTree/FileTabs/FileTypeIcon/FilePreview）。
+ *
+ * 分类按行为差异定义，无装饰类：
+ * - `code`     — 代码文本（可高亮语义）
+ * - `markdown` — 文本但需渲染为 HTML
+ * - `image`    — 二进制图片
+ * - `file`     — 其余兜底（普通文本/未知）
+ *
+ * DOC_EXTENSIONS（txt/rst/adoc 等）不构成 FileKind，只用于 FileTypeIcon
+ * 的图标细分（Book 图标），与行为无关。
+ */
+/** 代码文本扩展名（FileCode 图标；编辑器可语法高亮）。 */
+export declare const CODE_EXTENSIONS: readonly ["js", "jsx", "ts", "tsx", "py", "rb", "go", "rs", "java", "c", "cpp", "h", "sh", "bash", "zsh", "json", "yaml", "yml", "toml", "xml", "html", "css", "scss", "less", "sql"];
+/** Markdown 扩展名（需渲染为 HTML 的文本）。 */
+export declare const MARKDOWN_EXTENSIONS: readonly ["md", "mdx"];
+/** 纯文本文档扩展名（仅图标细分为 Book，行为与普通文本一致）。 */
+export declare const DOC_EXTENSIONS: readonly ["txt", "rst", "adoc"];
+/** 图片扩展名（二进制，图片预览）。 */
+export declare const IMAGE_EXTENSIONS: readonly ["png", "jpg", "jpeg", "gif", "webp", "svg", "bmp", "ico"];
+/** 行为分类。 */
+export type FileKind = 'code' | 'markdown' | 'image' | 'file';
+/** Lowercased extension (without dot) for a file name or path, or '' if none. */
+export declare function getExtension(name: string): string;
+/** 由扩展名推导行为分类。 */
+export declare function getFileKind(name: string): FileKind;
+/** 纯文本文档判定（仅图标细分用；不是 FileKind）。 */
+export declare function isTextDoc(name: string): boolean;
+/** 文件显示名（路径最后一段）。 */
+export declare function getFileLabel(filePath: string): string;
+//# sourceMappingURL=file-extensions.d.ts.map

package/dist/files/file-extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-extensions.d.ts","sourceRoot":"","sources":["../../src/files/file-extensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,qCAAqC;AACrC,eAAO,MAAM,eAAe,uLA0BlB,CAAC;AAEX,mCAAmC;AACnC,eAAO,MAAM,mBAAmB,wBAAyB,CAAC;AAE1D,uCAAuC;AACvC,eAAO,MAAM,cAAc,iCAAkC,CAAC;AAE9D,uBAAuB;AACvB,eAAO,MAAM,gBAAgB,qEAAsE,CAAC;AAEpG,YAAY;AACZ,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9D,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,kBAAkB;AAClB,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAMlD;AAED,mCAAmC;AACnC,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,qBAAqB;AACrB,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAErD"}

package/dist/files/file-extensions.js

@@ -0,0 +1,70 @@
+/**
+ * 文件扩展名分类 — files 域共用（FileTree/FileTabs/FileTypeIcon/FilePreview）。
+ *
+ * 分类按行为差异定义，无装饰类：
+ * - `code`     — 代码文本（可高亮语义）
+ * - `markdown` — 文本但需渲染为 HTML
+ * - `image`    — 二进制图片
+ * - `file`     — 其余兜底（普通文本/未知）
+ *
+ * DOC_EXTENSIONS（txt/rst/adoc 等）不构成 FileKind，只用于 FileTypeIcon
+ * 的图标细分（Book 图标），与行为无关。
+ */
+/** 代码文本扩展名（FileCode 图标；编辑器可语法高亮）。 */
+export const CODE_EXTENSIONS = [
+    'js',
+    'jsx',
+    'ts',
+    'tsx',
+    'py',
+    'rb',
+    'go',
+    'rs',
+    'java',
+    'c',
+    'cpp',
+    'h',
+    'sh',
+    'bash',
+    'zsh',
+    'json',
+    'yaml',
+    'yml',
+    'toml',
+    'xml',
+    'html',
+    'css',
+    'scss',
+    'less',
+    'sql',
+];
+/** Markdown 扩展名（需渲染为 HTML 的文本）。 */
+export const MARKDOWN_EXTENSIONS = ['md', 'mdx'];
+/** 纯文本文档扩展名（仅图标细分为 Book，行为与普通文本一致）。 */
+export const DOC_EXTENSIONS = ['txt', 'rst', 'adoc'];
+/** 图片扩展名（二进制，图片预览）。 */
+export const IMAGE_EXTENSIONS = ['png', 'jpg', 'jpeg', 'gif', 'webp', 'svg', 'bmp', 'ico'];
+/** Lowercased extension (without dot) for a file name or path, or '' if none. */
+export function getExtension(name) {
+    return name.split('.').pop()?.toLowerCase() ?? '';
+}
+/** 由扩展名推导行为分类。 */
+export function getFileKind(name) {
+    const ext = getExtension(name);
+    if (MARKDOWN_EXTENSIONS.includes(ext))
+        return 'markdown';
+    if (IMAGE_EXTENSIONS.includes(ext))
+        return 'image';
+    if (CODE_EXTENSIONS.includes(ext))
+        return 'code';
+    return 'file';
+}
+/** 纯文本文档判定（仅图标细分用；不是 FileKind）。 */
+export function isTextDoc(name) {
+    return DOC_EXTENSIONS.includes(getExtension(name));
+}
+/** 文件显示名（路径最后一段）。 */
+export function getFileLabel(filePath) {
+    return filePath.split('/').pop() ?? filePath;
+}
+//# sourceMappingURL=file-extensions.js.map

package/dist/files/file-extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-extensions.js","sourceRoot":"","sources":["../../src/files/file-extensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,qCAAqC;AACrC,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,MAAM;IACN,GAAG;IACH,KAAK;IACL,GAAG;IACH,IAAI;IACJ,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;CACG,CAAC;AAEX,mCAAmC;AACnC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,KAAK,CAAU,CAAC;AAE1D,uCAAuC;AACvC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAU,CAAC;AAE9D,uBAAuB;AACvB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAKpG,iFAAiF;AACjF,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AACpD,CAAC;AAED,kBAAkB;AAClB,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAK,mBAAyC,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,UAAU,CAAC;IAChF,IAAK,gBAAsC,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAC1E,IAAK,eAAqC,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IACxE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAQ,cAAoC,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,qBAAqB;AACrB,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAC;AAC/C,CAAC"}

package/dist/files/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @agentskillmania/skill-ui-shared — files 域类型定义
+ *
+ * 文件浏览（树/页签/预览）的通用契约，无 editor/gmemo 领域词汇。
+ */
+/** 文件树节点（通用文件系统形状）。 */
+export interface FileNode {
+    /** File path (relative to the workspace root, e.g. "README.md", "src/index.ts") */
+    path: string;
+    /** File content (optional — tree API typically doesn't return content) */
+    content?: string;
+    /** Whether it's a directory */
+    isDirectory?: boolean;
+    /** Child files (used for directories) */
+    children?: FileNode[];
+}
+/** 文件页签条目。 */
+export interface FileTab {
+    path: string;
+    label: string;
+    modified?: boolean;
+}
+export interface FileTreeProps {
+    files: FileNode[];
+    activeFilePath: string | null;
+    onSelect: (path: string) => void;
+}
+export interface FileTabsProps {
+    tabs: FileTab[];
+    activePath: string | null;
+    onTabChange: (path: string) => void;
+    onTabClose: (path: string) => void;
+}
+export interface FileTypeIconProps {
+    /** File name or path — classification is derived from its extension */
+    path: string;
+    /** Icon size in pixels (default 14) */
+    size?: number;
+}
+export interface FilePreviewProps {
+    /** File path — preview routing is derived from its extension */
+    path: string;
+    /** Text content to preview */
+    content: string;
+    /** Optional CSS class / style passthrough */
+    className?: string;
+    style?: React.CSSProperties;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/files/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/files/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,uBAAuB;AACvB,MAAM,WAAW,QAAQ;IACvB,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,cAAc;AACd,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B"}

package/dist/files/types.js

@@ -0,0 +1,7 @@
+/**
+ * @agentskillmania/skill-ui-shared — files 域类型定义
+ *
+ * 文件浏览（树/页签/预览）的通用契约，无 editor/gmemo 领域词汇。
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/files/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/files/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/index.d.ts

@@ -1,15 +1,22 @@
 /**
- * @agentskillmania/skill-ui-shared
- * Shared UI components, hooks, and style presets for the skill-ui ecosystem.
+ * @agentskillmania/skill-ui-shared — 通用基础层
+ *
+ * 按"面"组织，每个成员都有 ≥2 个宿主/领域包的真实消费者：
+ *
+ * - **files**：文件浏览域（FileTree / FileTabs / FilePreview / FileTypeIcon +
+ *   FileKind/getFileKind/getFileLabel + FileNode/FileTab 类型）——编辑器工作台
+ *   与 gmemo 边窗共用。
+ * - **display**：EmptyState —— FileTree/FilePreview/EditorWorkbench 共用的空态。
+ * - **utils**：formatTokens / formatDuration —— chat 与 editor 共用的格式化契约。
  */
-export { SectionHeader, EmptyState, ExpandableItem, CollapsibleCard, SplitDivider, Sidebar, SidebarPanel, SidebarIcons, MetricTile, SectionLabel, StatusDot, CopyValue, InfoRow, ExpandableRow, PaginationBar, } from './components/index.js';
-export type { SectionHeaderProps, EmptyStateProps, ExpandableItemProps, ExpandableItemContext, CollapsibleCardProps, SplitDividerProps, SidebarProps, SidebarPanelProps, SidebarIconsProps, SidebarIconItem, MetricTileProps, SectionLabelProps, StatusDotProps, CopyValueProps, InfoRowProps, ExpandableRowProps, DetailVariant, PaginationBarProps, } from './components/index.js';
-export { useToggle, useResize } from './hooks/index.js';
-export type { UseToggleReturn, UseResizeOptions, UseResizeReturn } from './hooks/index.js';
-export { cardBodyTransition, cardHeaderInteractive, expandableDetailTransition, expandableSummaryHover, metricsRow, metricGrid, emptyTextStyle, } from './styles/index.js';
-export { formatRelativeTime, formatTokens, formatNumber, formatDuration, truncate, formatTimestamp, } from './utils/format.js';
-export { PALETTE, hashId, getAvatarColor, getInitial } from './utils/avatar-color.js';
-export { FONT_DISPLAY } from './utils/fonts.js';
-export { DEFAULT_PAGE_SIZE } from './utils/pagination.js';
+export { FileTree } from './files/FileTree.js';
+export { FileTabs } from './files/FileTabs.js';
+export { FileTypeIcon } from './files/FileTypeIcon.js';
+export { FilePreview } from './files/FilePreview.js';
+export { getFileKind, getFileLabel, getExtension, CODE_EXTENSIONS, MARKDOWN_EXTENSIONS, IMAGE_EXTENSIONS, type FileKind, } from './files/file-extensions.js';
+export type { FileNode, FileTab, FileTreeProps, FileTabsProps, FileTypeIconProps, FilePreviewProps, } from './files/types.js';
+export { EmptyState } from './components/EmptyState.js';
+export type { EmptyStateProps } from './components/EmptyState.js';
+export { formatTokens, formatDuration } from './utils/format.js';
 export { NAMESPACE, resources } from './locales/index.js';
 //# sourceMappingURL=index.d.ts.map