@pactor-app/ui 0.1.0

package/dist/components/index.d.cts

@@ -0,0 +1,307 @@
+import { ComponentRegistry } from '@pactor-app/runtime';
+import * as React from 'react';
+import { ReactNode } from 'react';
+import { DslNode } from '@pactor-app/core';
+
+/** DSL Alert 变体 */
+type AlertVariant = 'success' | 'info' | 'warning' | 'error';
+interface AlertProps {
+    /** 提示主文案 */
+    message?: string;
+    /** 辅助说明文案 */
+    description?: string;
+    /** 变体，默认 info */
+    variant?: AlertVariant;
+}
+/** Alert 适配器（shadcn kit）：message → AlertTitle，description → AlertDescription */
+declare function Alert({ message, description, variant }: AlertProps): React.JSX.Element;
+
+/** DSL Button 变体（框架级协议） */
+type ButtonVariant = 'default' | 'primary' | 'dashed' | 'link' | 'text';
+/** DSL Button 尺寸 */
+type ButtonSize = 'small' | 'middle' | 'large';
+interface ButtonProps {
+    /** 按钮文本；也可用 children 渲染内容 */
+    text?: string;
+    /** 变体，默认 default */
+    variant?: ButtonVariant;
+    /** 危险态 */
+    danger?: boolean;
+    size?: ButtonSize;
+    loading?: boolean;
+    disabled?: boolean;
+    /** true 时作为 Form 的提交按钮（type=submit） */
+    submit?: boolean;
+    /** 点击事件（Renderer 绑定 events.onClick） */
+    onClick?: () => void;
+    children?: ReactNode;
+}
+/**
+ * Button 适配器（shadcn kit）：vendored shadcn Button（cva 变体）。
+ * props 契约与 pactor-components（antd 版）一致；`submit: true` 时作为
+ * Form 的提交按钮（type=submit）；danger 映射 destructive（link/text
+ * 变体保持原样、文字标红）；loading 显示旋转图标并禁用。
+ */
+declare function Button({ text, variant, danger, size, loading, disabled, submit, onClick, children, }: ButtonProps): React.JSX.Element;
+
+interface CardProps {
+    /** 卡片标题，可选 */
+    title?: string;
+    /** 是否有边框，默认 true（false 去边框与阴影） */
+    bordered?: boolean;
+    children?: ReactNode;
+}
+/** Card 适配器（shadcn kit）：可选标题 + 边框开关（bordered=false 去边框与阴影） */
+declare function Card({ title, bordered, children }: CardProps): React.JSX.Element;
+
+interface FlexProps {
+    /** 主轴方向，默认 horizontal */
+    direction?: 'horizontal' | 'vertical';
+    /** 间距 */
+    gap?: number | 'small' | 'middle' | 'large';
+    /** 主轴对齐 */
+    justify?: 'start' | 'center' | 'end' | 'space-between' | 'space-around' | 'space-evenly';
+    /** 交叉轴对齐 */
+    align?: 'start' | 'center' | 'end' | 'baseline' | 'stretch';
+    children?: ReactNode;
+}
+/** Flex 布局（shadcn kit）：方向 / 对齐映射 Tailwind 工具类，数字 gap 内联 */
+declare function Flex({ direction, gap, justify, align, children, }: FlexProps): React.JSX.Element;
+
+interface FormProps {
+    /** 表单名（缺省 'default'）：`form.setValues` 联动动作按名寻址 */
+    name?: string;
+    /** 表单布局，默认 vertical */
+    layout?: 'horizontal' | 'vertical' | 'inline';
+    /** 表单初始值（创建时生效；字段级 value 优先于 initialValues[name]） */
+    initialValues?: Record<string, unknown>;
+    children?: ReactNode;
+    /** 提交事件（校验通过后触发），参数为表单 values */
+    onSubmit?: (values: Record<string, unknown>) => void;
+    /** 任一字段变化事件（可选） */
+    onValuesChange?: (changed: Record<string, unknown>, values: Record<string, unknown>) => void;
+}
+/**
+ * Form 容器（shadcn kit，语义对齐 antd 版）：
+ * 维护受控 values 并经 React Context 下发，Form 内声明了 `name` 的
+ * Input / Select 自动成为表单项。创建时以 `initialValues` 初始化 values，
+ * 字段挂载注册时合并字段级 `value` 初始值（字段级优先，仅首次注册写入）。
+ * 提交（`submit: true` 的 Button）时：
+ * 1. 统一校验已注册字段的 rules（required + message），失败则展示错误并阻止提交
+ * 2. 校验通过把 values 写入 runtime state 的 `form` 路径（`${form.<field>}` 可用）
+ * 3. 以 values 调用 onSubmit（Renderer 把它放入 `event` 作用域）
+ */
+declare function Form({ name, layout, initialValues, children, onSubmit, onValuesChange, }: FormProps): React.JSX.Element;
+
+interface GridProps {
+    /** 列数，默认 1；每列等宽（columns 取整下限 1） */
+    columns?: number;
+    /** 栏间距 */
+    gap?: number;
+    children?: ReactNode;
+}
+/**
+ * Grid 均分栏布局（shadcn kit）：CSS grid。
+ * 列数为运行时动态值，无法用 Tailwind 静态类表达，经 inline style 设置。
+ */
+declare function Grid({ columns, gap, children }: GridProps): React.JSX.Element;
+
+/** DSL 校验规则（框架级协议，当前支持 required + message） */
+interface FieldRule {
+    required?: boolean;
+    message?: string;
+}
+interface InputProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 受控值（独立渲染时生效）；Form 内作为字段初始值（优先于 Form initialValues） */
+    value?: string;
+    /** 输入类型：password 时掩码输入（缺省 text） */
+    type?: 'text' | 'password';
+    placeholder?: string;
+    disabled?: boolean;
+    /** 输入事件，传出 string 值（非原生 event，设计决策 D2） */
+    onChange?: (value: string) => void;
+}
+/**
+ * Input 适配器（shadcn kit，语义对齐 antd 版）：
+ * 在 Form 内且声明 `name` 时自动成为表单项（label / rules 生效，
+ * 值由 Form 上下文托管）；否则渲染独立受控控件，onChange 传出 string。
+ * 表单项为去原语化结构（design D3）：`<div data-slot="form-item">` +
+ * `<label htmlFor>` 与控件 `useId` 关联。
+ */
+declare function Input({ name, label, rules, value, type, placeholder, disabled, onChange, }: InputProps): React.JSX.Element;
+
+interface PageProps {
+    /** 页面标题，可选 */
+    title?: string;
+    children?: ReactNode;
+}
+/** Page 容器（shadcn kit）：可选标题 + 内容区（纵向节奏 space-y-5） */
+declare function Page({ title, children }: PageProps): React.JSX.Element;
+
+/** Select 选项（支持表达式解析后的数组） */
+interface SelectOption {
+    label: string;
+    value: string | number | boolean;
+}
+interface SelectProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 选项列表 */
+    options?: SelectOption[];
+    /** 受控值（独立渲染时生效）；Form 内作为字段初始值（优先于 Form initialValues） */
+    value?: string | number | boolean;
+    placeholder?: string;
+    disabled?: boolean;
+    allowClear?: boolean;
+    /** 选中变化事件，传出选中的 value */
+    onChange?: (value: unknown) => void;
+}
+/**
+ * Select 适配器（shadcn kit，语义对齐 antd 版）：
+ * 基于 vendored shadcn Select（@base-ui/react）；Form 内声明 `name`
+ * 自动成为表单项；onChange 传出选中的原始 value（Base UI Select 的
+ * value 原生支持 string/number/boolean，无需序列化）。
+ *
+ * value→label 映射经 Root 的 `items` 提供：选中值对应的 item 尚未渲染过
+ * popup 时（如表单初始值回填），Trigger 同样显示 label（对齐原 Radix 坑
+ * 的对应场景，见 design D2/风险表）。
+ */
+declare function Select({ name, label, rules, options, value, placeholder, disabled, allowClear, onChange, }: SelectProps): React.JSX.Element;
+
+interface StatisticProps {
+    /** 指标标题 */
+    title?: string;
+    /** 指标数值（通常为表达式解析后的数字） */
+    value?: number | string;
+    /** 小数精度 */
+    precision?: number;
+    /** 后缀（如单位） */
+    suffix?: string;
+}
+/** Statistic 适配器（shadcn kit）：标题 + 数值（precision 精度 / suffix 后缀） */
+declare function Statistic({ title, value, precision, suffix }: StatisticProps): React.JSX.Element;
+
+/**
+ * 列定义；`cell` 为行模板 DSL 子树，每个单元格经 Renderer 子作用域
+ * 机制渲染，作用域注入 `row`（当前行记录）与 `rowIndex`（设计决策 D4）。
+ */
+interface TableColumn {
+    title?: string;
+    dataIndex?: string;
+    width?: number | string;
+    cell?: DslNode;
+}
+/** DSL 分页配置：false 关闭，`{ pageSize }` 简化映射 */
+type TablePagination = false | {
+    pageSize?: number;
+};
+/** 分页变化事件参数 */
+interface TablePaginationInfo {
+    current?: number;
+    pageSize?: number;
+    total?: number;
+}
+interface TableProps {
+    columns?: TableColumn[];
+    /** 数据行（通常为 `${data.xxx}` 表达式解析结果） */
+    dataSource?: Record<string, unknown>[];
+    /** 行 key 字段，默认 'id' */
+    rowKey?: string;
+    loading?: boolean;
+    pagination?: TablePagination;
+    /** 分页 / 排序变化事件，传出 pagination 信息 */
+    onChange?: (pagination: TablePaginationInfo) => void;
+}
+/**
+ * Table 适配器（shadcn kit，语义对齐 antd 版）：vendored shadcn Table 原语
+ * 实现 columns / dataSource / rowKey（默认 'id'）/ loading / 简化分页
+ * （pageSize）/ 空态；`cell` 行模板经 renderChildren 注入
+ * `{ row, rowIndex }`（rowIndex 为当前页内序号）。
+ */
+declare function Table({ columns, dataSource, rowKey, loading, pagination, onChange, }: TableProps): React.JSX.Element;
+
+/** Tabs 页签定义；`children` 为 DSL 子树，经 Renderer children 机制渲染 */
+interface TabItem {
+    key: string;
+    label: string;
+    children?: DslNode[];
+}
+interface TabsProps {
+    items?: TabItem[];
+    /** 当前激活页签 key（可绑表达式） */
+    activeKey?: string;
+    /** 页签切换事件，传出新激活的 key */
+    onChange?: (key: string) => void;
+}
+/**
+ * Tabs 容器（shadcn kit，语义对齐 antd 版）：
+ * 基于 vendored shadcn Tabs（@base-ui/react），每个 pane 的内容经
+ * renderChildren 渲染；未传 activeKey 时缺省激活第一个页签。
+ */
+declare function Tabs({ items, activeKey, onChange }: TabsProps): React.JSX.Element;
+
+/**
+ * shadcn kit 组件表：DSL 类型名 → 组件适配器。
+ * 类型名集合与 pactor-components 的 builtinComponents 完全一致；
+ * 容器组件（Tabs / Table）经 `useRenderer().renderChildren` 渲染 DSL 子树。
+ */
+declare const shadcnComponents: {
+    readonly Page: typeof Page;
+    readonly Grid: typeof Grid;
+    readonly Flex: typeof Flex;
+    readonly Card: typeof Card;
+    readonly Button: typeof Button;
+    readonly Alert: typeof Alert;
+    readonly Statistic: typeof Statistic;
+    readonly Tabs: typeof Tabs;
+    readonly Table: typeof Table;
+    readonly Form: typeof Form;
+    readonly Input: typeof Input;
+    readonly Select: typeof Select;
+};
+/** 把全部 V1 内置组件（shadcn 实现）按 DSL 类型名注册到给定 ComponentRegistry */
+declare function registerShadcnComponents(registry: ComponentRegistry): void;
+/** 创建并返回注册了全部 V1 内置组件（shadcn 实现）的新 ComponentRegistry */
+declare function createShadcnComponentRegistry(): ComponentRegistry;
+
+/**
+ * Form 容器上下文（shadcn kit）：Form 组件维护受控 values / 校验错误
+ * 并经 React Context 下发；Input / Select 据此判断自身是否在表单内。
+ * 不持有 UI 库表单实例，values 由框架侧受控管理（去原语化，见 design D3）。
+ */
+interface FormContextValue {
+    /** 标记后代字段处于 Form 容器内 */
+    inForm: true;
+    /** 表单布局（表单项排布 class 由字段侧按此生成） */
+    layout: 'horizontal' | 'vertical' | 'inline';
+    /** 当前表单 values（受控） */
+    values: Record<string, unknown>;
+    /** 校验错误（字段名 → 错误文案） */
+    errors: Record<string, string>;
+    /** 更新字段值（受控写入并清除该字段错误） */
+    setValue(name: string, value: unknown): void;
+    /** 批量写入字段值（form.setValues 联动桥）：不触发 onValuesChange 与校验 */
+    setValues(values: Record<string, unknown>): void;
+    /**
+     * 注册字段校验规则（提交时统一校验）；
+     * `initialValue` 为字段级初始值（value prop），仅在该字段首次注册时合并
+     * 进 values（字段级优先于 Form initialValues；已有合并结果不覆盖）
+     */
+    registerField(name: string, rules?: FieldRule[], initialValue?: unknown): void;
+    /** 注销字段 */
+    unregisterField(name: string): void;
+}
+/** 在字段组件内探测 Form 上下文；不在 Form 内时返回 null */
+declare function useFormContext(): FormContextValue | null;
+
+export { Alert, type AlertProps, type AlertVariant, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Card, type CardProps, type FieldRule, Flex, type FlexProps, Form, type FormContextValue, type FormProps, Grid, type GridProps, Input, type InputProps, Page, type PageProps, Select, type SelectOption, type SelectProps, Statistic, type StatisticProps, type TabItem, Table, type TableColumn, type TablePagination, type TablePaginationInfo, type TableProps, Tabs, type TabsProps, createShadcnComponentRegistry, registerShadcnComponents, shadcnComponents, useFormContext };

package/dist/components/index.d.ts

@@ -0,0 +1,307 @@
+import { ComponentRegistry } from '@pactor-app/runtime';
+import * as React from 'react';
+import { ReactNode } from 'react';
+import { DslNode } from '@pactor-app/core';
+
+/** DSL Alert 变体 */
+type AlertVariant = 'success' | 'info' | 'warning' | 'error';
+interface AlertProps {
+    /** 提示主文案 */
+    message?: string;
+    /** 辅助说明文案 */
+    description?: string;
+    /** 变体，默认 info */
+    variant?: AlertVariant;
+}
+/** Alert 适配器（shadcn kit）：message → AlertTitle，description → AlertDescription */
+declare function Alert({ message, description, variant }: AlertProps): React.JSX.Element;
+
+/** DSL Button 变体（框架级协议） */
+type ButtonVariant = 'default' | 'primary' | 'dashed' | 'link' | 'text';
+/** DSL Button 尺寸 */
+type ButtonSize = 'small' | 'middle' | 'large';
+interface ButtonProps {
+    /** 按钮文本；也可用 children 渲染内容 */
+    text?: string;
+    /** 变体，默认 default */
+    variant?: ButtonVariant;
+    /** 危险态 */
+    danger?: boolean;
+    size?: ButtonSize;
+    loading?: boolean;
+    disabled?: boolean;
+    /** true 时作为 Form 的提交按钮（type=submit） */
+    submit?: boolean;
+    /** 点击事件（Renderer 绑定 events.onClick） */
+    onClick?: () => void;
+    children?: ReactNode;
+}
+/**
+ * Button 适配器（shadcn kit）：vendored shadcn Button（cva 变体）。
+ * props 契约与 pactor-components（antd 版）一致；`submit: true` 时作为
+ * Form 的提交按钮（type=submit）；danger 映射 destructive（link/text
+ * 变体保持原样、文字标红）；loading 显示旋转图标并禁用。
+ */
+declare function Button({ text, variant, danger, size, loading, disabled, submit, onClick, children, }: ButtonProps): React.JSX.Element;
+
+interface CardProps {
+    /** 卡片标题，可选 */
+    title?: string;
+    /** 是否有边框，默认 true（false 去边框与阴影） */
+    bordered?: boolean;
+    children?: ReactNode;
+}
+/** Card 适配器（shadcn kit）：可选标题 + 边框开关（bordered=false 去边框与阴影） */
+declare function Card({ title, bordered, children }: CardProps): React.JSX.Element;
+
+interface FlexProps {
+    /** 主轴方向，默认 horizontal */
+    direction?: 'horizontal' | 'vertical';
+    /** 间距 */
+    gap?: number | 'small' | 'middle' | 'large';
+    /** 主轴对齐 */
+    justify?: 'start' | 'center' | 'end' | 'space-between' | 'space-around' | 'space-evenly';
+    /** 交叉轴对齐 */
+    align?: 'start' | 'center' | 'end' | 'baseline' | 'stretch';
+    children?: ReactNode;
+}
+/** Flex 布局（shadcn kit）：方向 / 对齐映射 Tailwind 工具类，数字 gap 内联 */
+declare function Flex({ direction, gap, justify, align, children, }: FlexProps): React.JSX.Element;
+
+interface FormProps {
+    /** 表单名（缺省 'default'）：`form.setValues` 联动动作按名寻址 */
+    name?: string;
+    /** 表单布局，默认 vertical */
+    layout?: 'horizontal' | 'vertical' | 'inline';
+    /** 表单初始值（创建时生效；字段级 value 优先于 initialValues[name]） */
+    initialValues?: Record<string, unknown>;
+    children?: ReactNode;
+    /** 提交事件（校验通过后触发），参数为表单 values */
+    onSubmit?: (values: Record<string, unknown>) => void;
+    /** 任一字段变化事件（可选） */
+    onValuesChange?: (changed: Record<string, unknown>, values: Record<string, unknown>) => void;
+}
+/**
+ * Form 容器（shadcn kit，语义对齐 antd 版）：
+ * 维护受控 values 并经 React Context 下发，Form 内声明了 `name` 的
+ * Input / Select 自动成为表单项。创建时以 `initialValues` 初始化 values，
+ * 字段挂载注册时合并字段级 `value` 初始值（字段级优先，仅首次注册写入）。
+ * 提交（`submit: true` 的 Button）时：
+ * 1. 统一校验已注册字段的 rules（required + message），失败则展示错误并阻止提交
+ * 2. 校验通过把 values 写入 runtime state 的 `form` 路径（`${form.<field>}` 可用）
+ * 3. 以 values 调用 onSubmit（Renderer 把它放入 `event` 作用域）
+ */
+declare function Form({ name, layout, initialValues, children, onSubmit, onValuesChange, }: FormProps): React.JSX.Element;
+
+interface GridProps {
+    /** 列数，默认 1；每列等宽（columns 取整下限 1） */
+    columns?: number;
+    /** 栏间距 */
+    gap?: number;
+    children?: ReactNode;
+}
+/**
+ * Grid 均分栏布局（shadcn kit）：CSS grid。
+ * 列数为运行时动态值，无法用 Tailwind 静态类表达，经 inline style 设置。
+ */
+declare function Grid({ columns, gap, children }: GridProps): React.JSX.Element;
+
+/** DSL 校验规则（框架级协议，当前支持 required + message） */
+interface FieldRule {
+    required?: boolean;
+    message?: string;
+}
+interface InputProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 受控值（独立渲染时生效）；Form 内作为字段初始值（优先于 Form initialValues） */
+    value?: string;
+    /** 输入类型：password 时掩码输入（缺省 text） */
+    type?: 'text' | 'password';
+    placeholder?: string;
+    disabled?: boolean;
+    /** 输入事件，传出 string 值（非原生 event，设计决策 D2） */
+    onChange?: (value: string) => void;
+}
+/**
+ * Input 适配器（shadcn kit，语义对齐 antd 版）：
+ * 在 Form 内且声明 `name` 时自动成为表单项（label / rules 生效，
+ * 值由 Form 上下文托管）；否则渲染独立受控控件，onChange 传出 string。
+ * 表单项为去原语化结构（design D3）：`<div data-slot="form-item">` +
+ * `<label htmlFor>` 与控件 `useId` 关联。
+ */
+declare function Input({ name, label, rules, value, type, placeholder, disabled, onChange, }: InputProps): React.JSX.Element;
+
+interface PageProps {
+    /** 页面标题，可选 */
+    title?: string;
+    children?: ReactNode;
+}
+/** Page 容器（shadcn kit）：可选标题 + 内容区（纵向节奏 space-y-5） */
+declare function Page({ title, children }: PageProps): React.JSX.Element;
+
+/** Select 选项（支持表达式解析后的数组） */
+interface SelectOption {
+    label: string;
+    value: string | number | boolean;
+}
+interface SelectProps {
+    /** 字段名；在 Form 内声明 name 即自动成为表单项 */
+    name?: string;
+    /** 表单项标签 */
+    label?: string;
+    /** 校验规则 */
+    rules?: FieldRule[];
+    /** 选项列表 */
+    options?: SelectOption[];
+    /** 受控值（独立渲染时生效）；Form 内作为字段初始值（优先于 Form initialValues） */
+    value?: string | number | boolean;
+    placeholder?: string;
+    disabled?: boolean;
+    allowClear?: boolean;
+    /** 选中变化事件，传出选中的 value */
+    onChange?: (value: unknown) => void;
+}
+/**
+ * Select 适配器（shadcn kit，语义对齐 antd 版）：
+ * 基于 vendored shadcn Select（@base-ui/react）；Form 内声明 `name`
+ * 自动成为表单项；onChange 传出选中的原始 value（Base UI Select 的
+ * value 原生支持 string/number/boolean，无需序列化）。
+ *
+ * value→label 映射经 Root 的 `items` 提供：选中值对应的 item 尚未渲染过
+ * popup 时（如表单初始值回填），Trigger 同样显示 label（对齐原 Radix 坑
+ * 的对应场景，见 design D2/风险表）。
+ */
+declare function Select({ name, label, rules, options, value, placeholder, disabled, allowClear, onChange, }: SelectProps): React.JSX.Element;
+
+interface StatisticProps {
+    /** 指标标题 */
+    title?: string;
+    /** 指标数值（通常为表达式解析后的数字） */
+    value?: number | string;
+    /** 小数精度 */
+    precision?: number;
+    /** 后缀（如单位） */
+    suffix?: string;
+}
+/** Statistic 适配器（shadcn kit）：标题 + 数值（precision 精度 / suffix 后缀） */
+declare function Statistic({ title, value, precision, suffix }: StatisticProps): React.JSX.Element;
+
+/**
+ * 列定义；`cell` 为行模板 DSL 子树，每个单元格经 Renderer 子作用域
+ * 机制渲染，作用域注入 `row`（当前行记录）与 `rowIndex`（设计决策 D4）。
+ */
+interface TableColumn {
+    title?: string;
+    dataIndex?: string;
+    width?: number | string;
+    cell?: DslNode;
+}
+/** DSL 分页配置：false 关闭，`{ pageSize }` 简化映射 */
+type TablePagination = false | {
+    pageSize?: number;
+};
+/** 分页变化事件参数 */
+interface TablePaginationInfo {
+    current?: number;
+    pageSize?: number;
+    total?: number;
+}
+interface TableProps {
+    columns?: TableColumn[];
+    /** 数据行（通常为 `${data.xxx}` 表达式解析结果） */
+    dataSource?: Record<string, unknown>[];
+    /** 行 key 字段，默认 'id' */
+    rowKey?: string;
+    loading?: boolean;
+    pagination?: TablePagination;
+    /** 分页 / 排序变化事件，传出 pagination 信息 */
+    onChange?: (pagination: TablePaginationInfo) => void;
+}
+/**
+ * Table 适配器（shadcn kit，语义对齐 antd 版）：vendored shadcn Table 原语
+ * 实现 columns / dataSource / rowKey（默认 'id'）/ loading / 简化分页
+ * （pageSize）/ 空态；`cell` 行模板经 renderChildren 注入
+ * `{ row, rowIndex }`（rowIndex 为当前页内序号）。
+ */
+declare function Table({ columns, dataSource, rowKey, loading, pagination, onChange, }: TableProps): React.JSX.Element;
+
+/** Tabs 页签定义；`children` 为 DSL 子树，经 Renderer children 机制渲染 */
+interface TabItem {
+    key: string;
+    label: string;
+    children?: DslNode[];
+}
+interface TabsProps {
+    items?: TabItem[];
+    /** 当前激活页签 key（可绑表达式） */
+    activeKey?: string;
+    /** 页签切换事件，传出新激活的 key */
+    onChange?: (key: string) => void;
+}
+/**
+ * Tabs 容器（shadcn kit，语义对齐 antd 版）：
+ * 基于 vendored shadcn Tabs（@base-ui/react），每个 pane 的内容经
+ * renderChildren 渲染；未传 activeKey 时缺省激活第一个页签。
+ */
+declare function Tabs({ items, activeKey, onChange }: TabsProps): React.JSX.Element;
+
+/**
+ * shadcn kit 组件表：DSL 类型名 → 组件适配器。
+ * 类型名集合与 pactor-components 的 builtinComponents 完全一致；
+ * 容器组件（Tabs / Table）经 `useRenderer().renderChildren` 渲染 DSL 子树。
+ */
+declare const shadcnComponents: {
+    readonly Page: typeof Page;
+    readonly Grid: typeof Grid;
+    readonly Flex: typeof Flex;
+    readonly Card: typeof Card;
+    readonly Button: typeof Button;
+    readonly Alert: typeof Alert;
+    readonly Statistic: typeof Statistic;
+    readonly Tabs: typeof Tabs;
+    readonly Table: typeof Table;
+    readonly Form: typeof Form;
+    readonly Input: typeof Input;
+    readonly Select: typeof Select;
+};
+/** 把全部 V1 内置组件（shadcn 实现）按 DSL 类型名注册到给定 ComponentRegistry */
+declare function registerShadcnComponents(registry: ComponentRegistry): void;
+/** 创建并返回注册了全部 V1 内置组件（shadcn 实现）的新 ComponentRegistry */
+declare function createShadcnComponentRegistry(): ComponentRegistry;
+
+/**
+ * Form 容器上下文（shadcn kit）：Form 组件维护受控 values / 校验错误
+ * 并经 React Context 下发；Input / Select 据此判断自身是否在表单内。
+ * 不持有 UI 库表单实例，values 由框架侧受控管理（去原语化，见 design D3）。
+ */
+interface FormContextValue {
+    /** 标记后代字段处于 Form 容器内 */
+    inForm: true;
+    /** 表单布局（表单项排布 class 由字段侧按此生成） */
+    layout: 'horizontal' | 'vertical' | 'inline';
+    /** 当前表单 values（受控） */
+    values: Record<string, unknown>;
+    /** 校验错误（字段名 → 错误文案） */
+    errors: Record<string, string>;
+    /** 更新字段值（受控写入并清除该字段错误） */
+    setValue(name: string, value: unknown): void;
+    /** 批量写入字段值（form.setValues 联动桥）：不触发 onValuesChange 与校验 */
+    setValues(values: Record<string, unknown>): void;
+    /**
+     * 注册字段校验规则（提交时统一校验）；
+     * `initialValue` 为字段级初始值（value prop），仅在该字段首次注册时合并
+     * 进 values（字段级优先于 Form initialValues；已有合并结果不覆盖）
+     */
+    registerField(name: string, rules?: FieldRule[], initialValue?: unknown): void;
+    /** 注销字段 */
+    unregisterField(name: string): void;
+}
+/** 在字段组件内探测 Form 上下文；不在 Form 内时返回 null */
+declare function useFormContext(): FormContextValue | null;
+
+export { Alert, type AlertProps, type AlertVariant, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Card, type CardProps, type FieldRule, Flex, type FlexProps, Form, type FormContextValue, type FormProps, Grid, type GridProps, Input, type InputProps, Page, type PageProps, Select, type SelectOption, type SelectProps, Statistic, type StatisticProps, type TabItem, Table, type TableColumn, type TablePagination, type TablePaginationInfo, type TableProps, Tabs, type TabsProps, createShadcnComponentRegistry, registerShadcnComponents, shadcnComponents, useFormContext };

package/dist/components/index.js

@@ -0,0 +1,40 @@
+import {
+  Alert,
+  Button,
+  Card,
+  Flex,
+  Form,
+  Grid,
+  Input,
+  Page,
+  Select,
+  Statistic,
+  Table,
+  Tabs,
+  createShadcnComponentRegistry,
+  registerShadcnComponents,
+  shadcnComponents,
+  useFormContext
+} from "../chunk-XGOTHOI6.js";
+import "../chunk-OUTSIJMO.js";
+import "../chunk-QWZ23QLS.js";
+import "../chunk-57NRUZ5G.js";
+import "../chunk-RQHJBTEU.js";
+export {
+  Alert,
+  Button,
+  Card,
+  Flex,
+  Form,
+  Grid,
+  Input,
+  Page,
+  Select,
+  Statistic,
+  Table,
+  Tabs,
+  createShadcnComponentRegistry,
+  registerShadcnComponents,
+  shadcnComponents,
+  useFormContext
+};