@printstack/print-studio 0.0.0-stage → 0.1.0

package/components/s-form/layouts/FlexLayout.d.ts

@@ -0,0 +1,89 @@
+import { PropType } from 'vue';
+import { SFormFlexLayoutProps, SFormLayoutItem, SFormResponsiveColumns } from '../types';
+/**
+ * 内置 flex 布局：行方向、自动换行、整体左对齐、行内顶对齐（均不可配置）。
+ * 元素级 layoutConfig：{ span, offset, width, minWidth, maxWidth }；宽度解析优先级 width > span > itemWidth > 默认 1 列。
+ * 宽度样式直接合并到元素根节点（不包裹 div），保证 t-form__item 仍是布局根的直接子元素，
+ * TDesign 才不会把每个字段误判为最后一项而丢失校验错误的预留空间。
+ * 折叠区以 display:none 隐藏（元素保持挂载，校验不遗漏），reveal 时自动展开再滚动定位。
+ */
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    collapsible: {
+        default: boolean;
+        type: BooleanConstructor;
+    };
+    /**
+     * 逻辑列数（span / offset 的换算基准），固定值或按容器宽度断点响应，默认 1
+     */
+    cols: {
+        default: number;
+        type: PropType<number | SFormResponsiveColumns>;
+    };
+    expandText: {
+        default: undefined;
+        type: PropType<[string, string] | undefined>;
+    };
+    gap: {
+        default: undefined;
+        type: PropType<SFormFlexLayoutProps["gap"]>;
+    };
+    items: {
+        default: () => never[];
+        type: PropType<SFormLayoutItem[]>;
+    };
+    /**
+     * 元素默认宽度（元素未声明 width / span 时使用）
+     */
+    itemWidth: {
+        default: undefined;
+        type: PropType<number | string | undefined>;
+    };
+    maxRows: {
+        default: undefined;
+        type: NumberConstructor;
+    };
+}>, () => import('vue/jsx-runtime').JSX.Element, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    collapsible: {
+        default: boolean;
+        type: BooleanConstructor;
+    };
+    /**
+     * 逻辑列数（span / offset 的换算基准），固定值或按容器宽度断点响应，默认 1
+     */
+    cols: {
+        default: number;
+        type: PropType<number | SFormResponsiveColumns>;
+    };
+    expandText: {
+        default: undefined;
+        type: PropType<[string, string] | undefined>;
+    };
+    gap: {
+        default: undefined;
+        type: PropType<SFormFlexLayoutProps["gap"]>;
+    };
+    items: {
+        default: () => never[];
+        type: PropType<SFormLayoutItem[]>;
+    };
+    /**
+     * 元素默认宽度（元素未声明 width / span 时使用）
+     */
+    itemWidth: {
+        default: undefined;
+        type: PropType<number | string | undefined>;
+    };
+    maxRows: {
+        default: undefined;
+        type: NumberConstructor;
+    };
+}>> & Readonly<{}>, {
+    items: SFormLayoutItem[];
+    gap: string | number | [string | number, string | number] | undefined;
+    collapsible: boolean;
+    cols: number | SFormResponsiveColumns;
+    expandText: [string, string] | undefined;
+    itemWidth: string | number | undefined;
+    maxRows: number;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;

package/components/s-form/layouts/GridLayout.d.ts

@@ -0,0 +1,67 @@
+import { PropType } from 'vue';
+import { SFormGridLayoutProps, SFormLayoutItem, SFormResponsiveColumns } from '../types';
+/**
+ * 内置 grid 布局。元素级 layoutConfig：{ span }（占据列数）、{ offset }（左侧空出列数，不回填）。
+ * 定位样式直接合并到元素根节点（不包裹 div），保证 t-form__item 仍是布局根的直接子元素，
+ * TDesign 才不会把每个字段误判为最后一项而丢失校验错误的预留空间。
+ * 折叠区以 display:none 隐藏（元素保持挂载，校验不遗漏），reveal 时自动展开再滚动定位。
+ */
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    collapsible: {
+        default: boolean;
+        type: BooleanConstructor;
+    };
+    cols: {
+        default: number;
+        type: PropType<number | SFormResponsiveColumns>;
+    };
+    expandText: {
+        default: undefined;
+        type: PropType<[string, string] | undefined>;
+    };
+    gap: {
+        default: undefined;
+        type: PropType<SFormGridLayoutProps["gap"]>;
+    };
+    items: {
+        default: () => never[];
+        type: PropType<SFormLayoutItem[]>;
+    };
+    maxRows: {
+        default: undefined;
+        type: NumberConstructor;
+    };
+}>, () => import('vue/jsx-runtime').JSX.Element, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    collapsible: {
+        default: boolean;
+        type: BooleanConstructor;
+    };
+    cols: {
+        default: number;
+        type: PropType<number | SFormResponsiveColumns>;
+    };
+    expandText: {
+        default: undefined;
+        type: PropType<[string, string] | undefined>;
+    };
+    gap: {
+        default: undefined;
+        type: PropType<SFormGridLayoutProps["gap"]>;
+    };
+    items: {
+        default: () => never[];
+        type: PropType<SFormLayoutItem[]>;
+    };
+    maxRows: {
+        default: undefined;
+        type: NumberConstructor;
+    };
+}>> & Readonly<{}>, {
+    items: SFormLayoutItem[];
+    gap: string | number | [string | number, string | number] | undefined;
+    collapsible: boolean;
+    cols: number | SFormResponsiveColumns;
+    expandText: [string, string] | undefined;
+    maxRows: number;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;

package/components/s-form/registry.d.ts

@@ -0,0 +1,31 @@
+import { Component } from 'vue';
+/**
+ * 全局注册表（模块级单例）：注册后全应用生效，无实例级注册入口。
+ * 类型层的配套扩展见 types.ts 中 SFormComponentRegistry / SFormLayoutRegistry。
+ */
+export declare const BUILTIN_LAYOUT_TYPES: readonly ["grid", "flex"];
+export type SFormBuiltinLayoutType = (typeof BUILTIN_LAYOUT_TYPES)[number];
+/**
+ * 内置布局的配置参数平铺在 layout 配置上；自定义布局的参数收拢在 params 键下
+ */
+export declare function isBuiltinSFormLayoutType(type: string): type is SFormBuiltinLayoutType;
+export interface RegisterSFormOptions {
+    /**
+     * 覆盖已存在的注册项时不告警
+     */
+    override?: boolean;
+}
+export declare function registerSFormComponent(type: string, component: Component, options?: RegisterSFormOptions): void;
+export declare function registerSFormComponents(components: Record<string, Component>, options?: RegisterSFormOptions): void;
+export declare function unregisterSFormComponent(type: string): void;
+/**
+ * @internal
+ */
+export declare function getSFormComponent(type: string): Component | undefined;
+export declare function registerSFormLayout(type: string, component: Component, options?: RegisterSFormOptions): void;
+export declare function registerSFormLayouts(layouts: Record<string, Component>, options?: RegisterSFormOptions): void;
+export declare function unregisterSFormLayout(type: string): void;
+/**
+ * @internal
+ */
+export declare function getSFormLayout(type: string): Component | undefined;

package/components/s-form/schema.d.ts

@@ -0,0 +1,9 @@
+import { SFormSchema, SFormSchemaItem, SFormSchemaNode, SFormValues } from './types';
+export declare function resolveNodeId(node: SFormSchemaNode): string;
+export declare function resolveHidden(node: SFormSchemaNode, values: SFormValues): boolean;
+export declare function walkSchema(schema: SFormSchema): Generator<SFormSchemaNode>;
+export declare function checkSchemaIds(schema: SFormSchema): void;
+export declare function buildSchemaIndex(schema: SFormSchema): {
+    dependents: Map<string, Set<string>>;
+    items: Map<string, SFormSchemaItem>;
+};

package/components/s-form/states.d.ts

@@ -0,0 +1,59 @@
+import { SFormAdapter } from './adapter';
+import { SFormFieldState, SFormFieldStatePatch, SFormSchemaItem, SFormValidateOptions, SFormValidateResult, SFormValidateStatus, SFormValues } from './types';
+/**
+ * 校验触发时机（与 TDesign ValidateTrigger 对齐）；
+ * validateFields 的全量校验以 'all' 匹配一切规则
+ */
+export type SFormValidateTrigger = 'all' | 'blur' | 'change';
+export interface SFormStateStoreConfig {
+    adapter: SFormAdapter;
+    /**
+     * 依赖指定字段的其他字段（dependencies 倒排索引，SForm 从 schema 派生）
+     */
+    getDependents(field: string): string[];
+    /**
+     * schema 全部字段路径（含隐藏字段）
+     */
+    getFields(): string[];
+    /**
+     * 字段对应的 schema 条目（rules / label / status 一等覆盖）
+     */
+    getItem(field: string): SFormSchemaItem | undefined;
+    getValue(field: string): unknown;
+    getValues(): SFormValues;
+    /**
+     * 字段当前是否隐藏（隐藏字段跳过校验）
+     */
+    isHidden(field: string): boolean;
+}
+export interface SFormStateStore {
+    clearFieldStates(fields?: string[]): void;
+    /**
+     * 停止一切调度与在途校验（表单卸载时调用），结果不再写回
+     */
+    dispose(): void;
+    /**
+     * 字段 → 响应式状态（touched / validating / 消息）
+     */
+    fieldStates: Record<string, SFormFieldState>;
+    getFieldState(field: string): SFormFieldState;
+    isFieldsTouched(fields?: string[], allTouched?: boolean): boolean;
+    isFieldTouched(field: string): boolean;
+    /**
+     * 控件失焦路径：调度 blur 校验
+     */
+    markFieldBlur(field: string): void;
+    /**
+     * 用户输入路径：标记字段已操作并调度 change 校验（联动 dependencies）
+     */
+    markFieldInput(field: string): void;
+    resetStates(): void;
+    setFieldState(field: string, patch: SFormFieldStatePatch): void;
+    validateFields(options?: SFormValidateOptions): Promise<SFormValidateResult>;
+}
+/**
+ * 解析字段的展示状态：手动覆盖 > validating > error > warning；
+ * 校验通过不自动生成 success（如需绿色反馈可手动 status: 'success'）
+ */
+export declare function resolveFieldStatus(manualStatus: SFormValidateStatus | undefined, state: SFormFieldState | undefined): SFormValidateStatus | undefined;
+export declare function createSFormStateStore(config: SFormStateStoreConfig): SFormStateStore;