@open-dy/vibecoding-sdk-taro 0.0.1-beta.5 → 0.0.1

package/src/ui/table.tsx

@@ -0,0 +1,240 @@
+import type { CSSProperties } from "react"
+import { View, type ViewProps } from "@tarojs/components"
+
+import { cn } from "../lib/utils"
+
+type TableCellProps = ViewProps & {
+  /** @desc 兼容的列占比参数；TableCell 仅在传入 style 且未用 w-* 类固定宽度时转换为 flexGrow，并非原生表格合并。TableHead 不做此转换。 */
+  colSpan?: number
+}
+
+function getColSpanStyle(
+  colSpan: number | undefined,
+  className: ViewProps["className"],
+  style: ViewProps["style"]
+) {
+  if (
+    colSpan == null ||
+    typeof className === "string" && /(^|\s)w-/.test(className) ||
+    style == null
+  ) {
+    return style
+  }
+
+  if (typeof style === "string") {
+    return `flex-grow: ${colSpan}; ${style}`
+  }
+
+  if (typeof style === "object" && !Array.isArray(style)) {
+    return {
+      ...(style as CSSProperties),
+      flexGrow: colSpan,
+    }
+  }
+
+  return style
+}
+
+/**
+ * @desc 表格组件。
+ * @param {Parameters<typeof Table>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Table>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table />
+ * ```
+ */
+function Table({ className, ...props }: ViewProps) {
+  return (
+    <View
+      data-slot="table-container"
+      className="relative w-full overflow-x-auto"
+    >
+      <View
+        data-slot="table"
+        className={cn("w-full caption-bottom text-sm", className)}
+        {...props}
+      />
+    </View>
+  )
+}
+
+/**
+ * @desc 表格头部布局。
+ * @param {Parameters<typeof TableHeader>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableHeader>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableHeader } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableHeader /></Table>
+ * ```
+ */
+function TableHeader({ className, ...props }: ViewProps) {
+  return (
+    <View
+      data-slot="table-header"
+      className={cn("[&>*]:border-b", className)}
+      {...props}
+    />
+  )
+}
+
+/**
+ * @desc 表格主体区域。
+ * @param {Parameters<typeof TableBody>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableBody>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableBody } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableBody /></Table>
+ * ```
+ */
+function TableBody({ className, ...props }: ViewProps) {
+  return (
+    <View
+      data-slot="table-body"
+      className={cn("[&>*:last-child]:border-0", className)}
+      {...props}
+    />
+  )
+}
+
+/**
+ * @desc 表格底部布局。
+ * @param {Parameters<typeof TableFooter>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableFooter>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableFooter } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableFooter /></Table>
+ * ```
+ */
+function TableFooter({ className, ...props }: ViewProps) {
+  return (
+    <View
+      data-slot="table-footer"
+      className={cn(
+        "border-t bg-muted/50 font-medium [&>*:last-child]:border-b-0",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+/**
+ * @desc 表格行容器。
+ * @param {Parameters<typeof TableRow>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableRow>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableRow } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableRow /></Table>
+ * ```
+ */
+function TableRow({ className, ...props }: ViewProps) {
+  return (
+    <View
+      data-slot="table-row"
+      className={cn(
+        "flex border-b transition-colors hover:bg-muted/50 aria-selected:bg-muted",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+/**
+ * @desc 表格表头单元格。
+ * @param {Parameters<typeof TableHead>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableHead>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableHead } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableHead /></Table>
+ * ```
+ */
+function TableHead({ className, ...props }: TableCellProps) {
+  return (
+    <View
+      data-slot="table-head"
+      className={cn(
+        "h-10 px-2 text-left align-middle font-medium whitespace-nowrap text-foreground flex flex-1 basis-0 min-w-0 items-center justify-start",
+        typeof className === "string" && /(^|\s)text-right(\s|$)/.test(className)
+          ? "justify-end"
+          : null,
+        typeof className === "string" && /(^|\s)w-/.test(className)
+          ? "flex-none basis-auto"
+          : null,
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+/**
+ * @desc 表格单元格。
+ * @param {Parameters<typeof TableCell>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableCell>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableCell } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableCell /></Table>
+ * ```
+ */
+function TableCell({ className, colSpan, style, ...props }: TableCellProps) {
+  return (
+    <View
+      data-slot="table-cell"
+      style={getColSpanStyle(colSpan, className, style)}
+      className={cn(
+        "p-2 align-middle whitespace-nowrap flex flex-1 basis-0 min-w-0 items-center justify-start",
+        typeof className === "string" && /(^|\s)text-right(\s|$)/.test(className)
+          ? "justify-end"
+          : null,
+        typeof className === "string" && /(^|\s)w-/.test(className)
+          ? "flex-none basis-auto"
+          : null,
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+/**
+ * @desc 表格的说明文本。
+ * @param {Parameters<typeof TableCaption>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TableCaption>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Table, TableCaption } from '@open-dy/vibecoding-sdk-taro/ui/table'
+ * <Table><TableCaption /></Table>
+ * ```
+ */
+function TableCaption({
+  className,
+  ...props
+}: ViewProps) {
+  return (
+    <View
+      data-slot="table-caption"
+      className={cn("mt-4 text-sm text-muted-foreground", className)}
+      {...props}
+    />
+  )
+}
+
+export {
+  Table,
+  TableHeader,
+  TableBody,
+  TableFooter,
+  TableHead,
+  TableRow,
+  TableCell,
+  TableCaption,
+}

package/src/ui/tabs.tsx

@@ -0,0 +1,233 @@
+import * as React from "react"
+import { View, type ViewProps } from "@tarojs/components"
+import { cva, type VariantProps } from "class-variance-authority"
+
+import { cn } from "../lib/utils"
+import { collectDataIconState } from "./helpers"
+
+const TabsContext = React.createContext<{
+  value?: string
+  onValueChange?: (value: string) => void
+  orientation?: "horizontal" | "vertical"
+}>({})
+
+const TabsListContext = React.createContext<{
+  variant?: "default" | "line"
+}>({})
+
+/**
+ * @desc 标签页组件。
+ * @param {Parameters<typeof Tabs>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof Tabs>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Tabs } from '@open-dy/vibecoding-sdk-taro/ui/tabs'
+ * <Tabs />
+ * ```
+ */
+function Tabs({
+  className,
+  orientation = "horizontal",
+  value: valueProp,
+  defaultValue,
+  onValueChange,
+  children,
+  ...props
+}: ViewProps & {
+  /** @desc 页签排列方向：horizontal 横排、vertical 竖排；默认 horizontal，同时影响触发器和内容区布局。 */
+  orientation?: "horizontal" | "vertical"
+  /** @desc 受控选中项的标识；传入后以该值为准，需在 onValueChange 中更新。省略时由内部状态管理。 */
+  value?: string
+  /** @desc 非受控模式的初始选中页签，默认空字符串（没有选中项）；传入 value 后不生效。 */
+  defaultValue?: string
+  /** @desc 用户选择项目时调用，参数为下一选中项标识；受控模式需由调用方同步 value。 */
+  onValueChange?: (value: string) => void
+}) {
+  const [internal, setInternal] = React.useState(defaultValue ?? "")
+  const controlled = valueProp !== undefined
+  const value = controlled ? valueProp : internal
+
+  return (
+    <TabsContext.Provider
+      value={{
+        value,
+        onValueChange: (v) => {
+          if (!controlled) setInternal(v)
+          onValueChange?.(v)
+        },
+        orientation,
+      }}
+    >
+      <View
+        data-slot="tabs"
+        className={cn(
+          "group/tabs flex gap-2",
+          orientation === "horizontal" && "flex-col",
+          className
+        )}
+        {...props}
+      >
+        {children}
+      </View>
+    </TabsContext.Provider>
+  )
+}
+
+/**
+ * @desc 生成标签页列表的样式类名；接受其声明的样式变体。
+ * @param {Parameters<typeof tabsListVariants>[0]} props 样式变体以及附加的 class 或 className。
+ * @param {Parameters<typeof tabsListVariants>[0]["variant"]} props.variant 列表样式，默认 default（圆角底色），line 为透明底；同时通过上下文控制触发器的选中下划线。
+ * @return {string} 合并后的样式类名。
+ * @example
+ * ```tsx
+ * import { tabsListVariants } from '@open-dy/vibecoding-sdk-taro/ui/tabs'
+ * tabsListVariants()
+ * ```
+ */
+const tabsListVariants = cva(
+  "group/tabs-list inline-flex w-fit items-center justify-center p-1 text-muted-foreground",
+  {
+    variants: {
+      variant: {
+        default: "rounded-lg bg-muted",
+        line: "gap-1 rounded-none bg-transparent",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+    },
+  }
+)
+
+/**
+ * @desc 标签页列表容器。
+ * @param {Parameters<typeof TabsList>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TabsList>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Tabs, TabsList } from '@open-dy/vibecoding-sdk-taro/ui/tabs'
+ * <Tabs><TabsList /></Tabs>
+ * ```
+ */
+function TabsList({
+  className,
+  variant = "default",
+  ...props
+}: ViewProps & VariantProps<typeof tabsListVariants> & {
+  /** @desc 页签列表样式，默认 default（圆角底色），line 为透明底和选中下划线；由上下文影响 TabsTrigger。 */
+  variant?: "default" | "line" }) {
+  const tabs = React.useContext(TabsContext)
+
+  return (
+    <TabsListContext.Provider value={{ variant }}>
+      <View
+        data-slot="tabs-list"
+        className={cn(
+          tabsListVariants({ variant }),
+          tabs.orientation === "horizontal" && "h-8",
+          tabs.orientation === "vertical" && "h-fit flex-col",
+          className
+        )}
+        {...props}
+      />
+    </TabsListContext.Provider>
+  )
+}
+
+/**
+ * @desc 标签页触发器。
+ * @param {Parameters<typeof TabsTrigger>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TabsTrigger>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Tabs, TabsTrigger } from '@open-dy/vibecoding-sdk-taro/ui/tabs'
+ * <Tabs><TabsTrigger value="one" /></Tabs>
+ * ```
+ */
+function TabsTrigger({
+  className,
+  value,
+  children,
+  disabled,
+  ...props
+}: ViewProps & {
+  /** @desc 当前项目的唯一标识；必须与父组件的 value/defaultValue 对应，不同项目使用不同值。 */
+  value: string;
+  /** @desc 是否禁用当前页签；默认可操作，禁用后不执行内部页签切换。 */
+  disabled?: boolean }) {
+  const ctx = React.useContext(TabsContext)
+  const list = React.useContext(TabsListContext)
+  const isActive = ctx.value === value
+  const { hasInlineStartIcon, hasInlineEndIcon } = React.useMemo(
+    () => collectDataIconState(children),
+    [children]
+  )
+
+  return (
+    <View
+      data-slot="tabs-trigger"
+      aria-disabled={disabled || undefined}
+      className={cn(
+        "relative inline-flex h-[calc(100%-1px)] flex-1 items-center justify-center gap-1.5 rounded-md border border-transparent px-1.5 py-0.5 text-sm font-medium whitespace-nowrap text-foreground/60 transition-all hover:text-foreground focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 focus-visible:outline-1 focus-visible:outline-ring disabled:pointer-events-none disabled:opacity-50 aria-disabled:pointer-events-none aria-disabled:opacity-50 dark:text-muted-foreground dark:hover:text-foreground [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        ctx.orientation === "vertical" && "w-full justify-start",
+        list.variant === "line" && "bg-transparent",
+        hasInlineStartIcon && "pl-1",
+        hasInlineEndIcon && "pr-1",
+        isActive &&
+          "bg-background text-foreground dark:border-input dark:bg-input/30 dark:text-foreground",
+        list.variant === "default" && isActive && "shadow-sm",
+        list.variant === "line" &&
+          isActive &&
+          "bg-transparent shadow-none dark:border-transparent dark:bg-transparent",
+        "after:absolute after:bg-foreground after:opacity-0 after:transition-opacity",
+        ctx.orientation === "horizontal" &&
+          "after:inset-x-0 after:bottom-[-5px] after:h-0.5",
+        ctx.orientation === "vertical" &&
+          "after:inset-y-0 after:-right-1 after:w-0.5",
+        list.variant === "line" && isActive && "after:opacity-100",
+        className
+      )}
+      onClick={() => {
+        if (disabled) return
+        ctx.onValueChange?.(value)
+      }}
+      {...props}
+    >
+      {children}
+    </View>
+  )
+}
+
+/**
+ * @desc 标签页内容容器。
+ * @param {Parameters<typeof TabsContent>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @return {ReturnType<typeof TabsContent>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Tabs, TabsContent } from '@open-dy/vibecoding-sdk-taro/ui/tabs'
+ * <Tabs><TabsContent value="one" /></Tabs>
+ * ```
+ */
+function TabsContent({
+  className,
+  value,
+  children,
+  ...props
+}: ViewProps & {
+  /** @desc 内容区对应的页签标识；须与 TabsTrigger.value 相同，仅父 Tabs.value 匹配时渲染。 */
+  value: string }) {
+  const ctx = React.useContext(TabsContext)
+  if (ctx.value !== value) return null
+
+  return (
+    <View
+      data-slot="tabs-content"
+      className={cn("flex-1 text-sm outline-none", className)}
+      {...props}
+    >
+      {children}
+    </View>
+  )
+}
+
+export { Tabs, TabsList, TabsTrigger, TabsContent, tabsListVariants }

package/src/ui/tailwind.css

@@ -0,0 +1,2 @@
+@import "./theme.css";
+@source "./";

package/src/ui/textarea.tsx

@@ -0,0 +1,49 @@
+import { Textarea as TaroTextarea, View } from "@tarojs/components"
+
+import { cn } from "../lib/utils"
+
+/**
+ * @desc 多行输入框组件。
+ * @param {Parameters<typeof Textarea>[0]} props 组件属性；自有字段的用途及默认行为见下表，继承属性另列。
+ * @param {Parameters<typeof Textarea>[0]["className"]} props.className 外层 View 的附加类名；内部 Textarea 使用自己的填满容器样式。
+ * @param {Parameters<typeof Textarea>[0]["style"]} props.style 外层 View 的内联样式；不会原样传给内部 Textarea。
+ * @param {Parameters<typeof Textarea>[0]["onInput"]} props.onInput 原生 Textarea 输入事件，文字值从 event.detail.value 读取；调用方自行同步输入状态。
+ * @return {ReturnType<typeof Textarea>} 组件渲染结果；类型见返回值契约。
+ * @example
+ * ```tsx
+ * import { Textarea } from '@open-dy/vibecoding-sdk-taro/ui/textarea'
+ * <Textarea />
+ * ```
+ */
+function Textarea({
+  className,
+  style,
+  ...props
+}: React.ComponentPropsWithoutRef<typeof TaroTextarea>) {
+  const disabled = !!(props as any).disabled
+  const ariaInvalid = (props as any)["aria-invalid"]
+  const invalid =
+    ariaInvalid !== undefined &&
+    ariaInvalid !== false &&
+    ariaInvalid !== "false"
+
+  return (
+    <View
+      data-slot="textarea"
+      style={style}
+      className={cn(
+        "flex h-20 field-sizing-content min-h-16 w-full rounded-lg border border-input bg-transparent px-2.5 py-2 text-base transition-colors outline-none placeholder:text-muted-foreground focus-within:border-ring focus-within:ring-3 focus-within:ring-ring/50 md:text-sm dark:bg-input/30",
+        disabled && "cursor-not-allowed bg-input/50 opacity-50 dark:bg-input/80",
+        invalid && "border-destructive ring-3 ring-destructive/20 dark:border-destructive/50 dark:ring-destructive/40",
+        className
+      )}
+    >
+      <TaroTextarea
+        className="w-full flex-1 !h-full bg-transparent text-sm outline-none resize-none"
+        {...props}
+      />
+    </View>
+  )
+}
+
+export { Textarea }