@sia.soul/sia-react-ui 0.1.0

package/README.md

@@ -0,0 +1,37 @@
+# Sia React UI
+
+SiaWebUI 的 React 组件库，包含基础控件、布局、表格、编辑器和图表。
+
+## 安装
+
+在已有 React 项目中执行：
+
+```powershell
+pnpm add '@sia.soul/sia-react-ui'
+```
+
+项目需要提供 React 和 React DOM。包声明的 peerDependencies 为 React >=18；具体兼容性以项目实际验证为准。
+
+## 使用
+
+在应用入口引入一次样式：
+
+```tsx
+import '@sia.soul/sia-react-ui/styles.css';
+```
+
+在组件中使用：
+
+```tsx
+import { Button } from '@sia.soul/sia-react-ui';
+
+export default function App() {
+  return <Button>你好，SiaWebUI</Button>;
+}
+```
+
+也提供 `/core`、`/select-date-range`、`/rich-text-editor`、`/markdown-editor` 和 `/chart` 子入口。子入口不会减少包管理器安装的依赖数量。
+
+代码编辑器使用 Monaco 和 worker 导入；在接入其他构建工具时，需要验证 worker 配置。本包的组件需要浏览器环境，服务端渲染兼容性需单独验证。
+
+第三方说明见 THIRD_PARTY_NOTICES.md。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,12 @@
+# Third-party notices
+
+## Ant Design Icons
+
+Sia Web UI 的图标语义、分类和部分基础构图参考了 Ant Design Icons。Sia 图标路径已针对统一的圆角描边视觉重新绘制。
+
+Ant Design Icons is licensed under the MIT License.
+
+- Project: https://github.com/ant-design/ant-design-icons
+- Copyright: Ant Design Team
+- License: https://github.com/ant-design/ant-design-icons/blob/master/LICENSE
+

package/dist/Select-CJJ5LQap.d.cts

@@ -0,0 +1,44 @@
+import * as react from 'react';
+import { ButtonHTMLAttributes, ReactNode } from 'react';
+
+type ControlSize = "small" | "medium" | "large";
+type ControlStatus = "default" | "warning" | "error";
+type InputPlaceholderMode = "default" | "floating";
+
+type SelectValue = string | number;
+type SelectMode = "single" | "multiple";
+type SelectChangeValue = SelectValue | SelectValue[] | null;
+type SelectOption = {
+    label: ReactNode;
+    value: SelectValue;
+    disabled?: boolean;
+};
+interface SelectProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "defaultValue" | "onChange" | "value"> {
+    options: readonly SelectOption[];
+    mode?: SelectMode;
+    value?: SelectChangeValue;
+    defaultValue?: SelectChangeValue;
+    onChange?: (value: SelectChangeValue, option: SelectOption | SelectOption[] | null) => void;
+    placeholder?: ReactNode;
+    size?: ControlSize;
+    status?: ControlStatus;
+    allowClear?: boolean;
+    loading?: boolean;
+    showSearch?: boolean;
+    /** 允许将搜索框内容作为自定义选项提交。 */
+    allowInput?: boolean;
+    inputMaxLength?: number;
+    searchPlaceholder?: string;
+    onSearch?: (query: string) => void;
+    filterOption?: (query: string, option: SelectOption) => boolean;
+    showSelectAll?: boolean;
+    maxTagCount?: number;
+    virtual?: boolean;
+    virtualThreshold?: number;
+    listHeight?: number;
+    optionHeight?: number;
+    notFoundContent?: ReactNode;
+}
+declare const Select: react.ForwardRefExoticComponent<SelectProps & react.RefAttributes<HTMLButtonElement>>;
+
+export { type ControlSize as C, type InputPlaceholderMode as I, Select as S, type ControlStatus as a, type SelectChangeValue as b, type SelectMode as c, type SelectOption as d, type SelectProps as e, type SelectValue as f };

package/dist/Select-CJJ5LQap.d.ts

@@ -0,0 +1,44 @@
+import * as react from 'react';
+import { ButtonHTMLAttributes, ReactNode } from 'react';
+
+type ControlSize = "small" | "medium" | "large";
+type ControlStatus = "default" | "warning" | "error";
+type InputPlaceholderMode = "default" | "floating";
+
+type SelectValue = string | number;
+type SelectMode = "single" | "multiple";
+type SelectChangeValue = SelectValue | SelectValue[] | null;
+type SelectOption = {
+    label: ReactNode;
+    value: SelectValue;
+    disabled?: boolean;
+};
+interface SelectProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "defaultValue" | "onChange" | "value"> {
+    options: readonly SelectOption[];
+    mode?: SelectMode;
+    value?: SelectChangeValue;
+    defaultValue?: SelectChangeValue;
+    onChange?: (value: SelectChangeValue, option: SelectOption | SelectOption[] | null) => void;
+    placeholder?: ReactNode;
+    size?: ControlSize;
+    status?: ControlStatus;
+    allowClear?: boolean;
+    loading?: boolean;
+    showSearch?: boolean;
+    /** 允许将搜索框内容作为自定义选项提交。 */
+    allowInput?: boolean;
+    inputMaxLength?: number;
+    searchPlaceholder?: string;
+    onSearch?: (query: string) => void;
+    filterOption?: (query: string, option: SelectOption) => boolean;
+    showSelectAll?: boolean;
+    maxTagCount?: number;
+    virtual?: boolean;
+    virtualThreshold?: number;
+    listHeight?: number;
+    optionHeight?: number;
+    notFoundContent?: ReactNode;
+}
+declare const Select: react.ForwardRefExoticComponent<SelectProps & react.RefAttributes<HTMLButtonElement>>;
+
+export { type ControlSize as C, type InputPlaceholderMode as I, Select as S, type ControlStatus as a, type SelectChangeValue as b, type SelectMode as c, type SelectOption as d, type SelectProps as e, type SelectValue as f };