@gct-paas/word 0.1.74-beta.40 → 0.1.74-beta.41

package/dist/domain/field/field-type.d.ts

@@ -374,6 +374,18 @@ export declare const BUSINESS_FIELD_TYPE: {
      * 物料消耗对象
      */
     readonly MATERIAL_CONSUME: "material_consume";
+    /**
+     * 物料日期对象
+     */
+    readonly DATE_OBJECT: "date_object";
+    /**
+     * 有效期
+     */
+    readonly VALIDITY: "validity";
+    /**
+     * 下一次复检日期
+     */
+    readonly RE_INSPECTION_DATE: "re_inspection_date";
     /**
      * 数量
      */
@@ -574,6 +586,18 @@ export declare const FIELD_TYPE: {
      * 物料消耗对象
      */
     readonly MATERIAL_CONSUME: "material_consume";
+    /**
+     * 物料日期对象
+     */
+    readonly DATE_OBJECT: "date_object";
+    /**
+     * 有效期
+     */
+    readonly VALIDITY: "validity";
+    /**
+     * 下一次复检日期
+     */
+    readonly RE_INSPECTION_DATE: "re_inspection_date";
     /**
      * 数量
      */

package/dist/domain/object/date-object/index.d.ts

@@ -0,0 +1,4 @@
+export { profile as dateObjectProfile, OBJECT_TYPE } from './profile';
+export { DateObjectRuntime } from './runtime/date-object-runtime';
+export { DateObjectContext } from './runtime/date-object-context';
+export type { DateObjectProfile } from './types';

package/dist/domain/object/date-object/profile/field-keys.d.ts

@@ -0,0 +1,19 @@
+/** 批次 / 物料下拉 option 上的字段 */
+export declare const OptionF: {
+    /** 物料 */
+    readonly productId: "product_id_";
+    /** 生产日期 */
+    readonly productionDate: "production_date_";
+    /** 有效期 */
+    readonly validity: "validate_";
+    /** 下一次复检日期 */
+    readonly reInspectionDate: "re_inspection_date_";
+    /** 复检周期 */
+    readonly reInspectionInterval: "re_inspection_interval_";
+    /** 复检周期单位 */
+    readonly reInspectionIntervalUnit: "re_inspection_interval_unit_";
+};
+/** paramsConfig.txnConfig.businessType：复检场景 */
+export declare const RE_INSPECTION_BUSINESS_TYPE = "reInspection";
+/** 真正要按周期计算、但物料未配周期时的提示 */
+export declare const MISSING_RE_INSPECTION_INTERVAL_MSG = "\u5F53\u524D\u7269\u6599\u672A\u914D\u7F6E\u590D\u68C0\u5468\u671F\uFF0C\u65E0\u6CD5\u8BA1\u7B97\u4E0B\u4E00\u6B21\u590D\u68C0\u65E5\u671F";

package/dist/domain/object/date-object/profile/fields.d.ts

@@ -0,0 +1,2 @@
+import { DateObjectFieldProfile } from '../types';
+export declare const fields: DateObjectFieldProfile[];

package/dist/domain/object/date-object/profile/index.d.ts

@@ -0,0 +1,3 @@
+import { DateObjectProfile } from '../types';
+export declare const OBJECT_TYPE: "date_object";
+export declare const profile: DateObjectProfile;

package/dist/domain/object/date-object/runtime/date-object-context.d.ts

@@ -0,0 +1,41 @@
+import { Doc } from '../../../../core';
+import { FIELD_TYPE } from '../../../field/field-type';
+import { DateObjectFieldProfile, DateObjectProfile } from '../types';
+/** 日期对象子字段身份：控件 fieldLink 末段即主表 field key */
+interface DateObjectChildField {
+    key: string;
+}
+/** 同一日期对象下的子字段，按 bizType 索引 */
+interface DateObjectFieldSet {
+    belongingObject: string;
+    byBizType: Partial<Record<FIELD_TYPE, DateObjectChildField>>;
+}
+/** 单个物料日期对象实例：Profile + 同组字段 */
+export declare class DateObjectContext {
+    readonly doc: Doc;
+    readonly profile: DateObjectProfile;
+    readonly belongingObject: string;
+    readonly fieldSet: DateObjectFieldSet;
+    /**
+     * @param doc 当前文档
+     * @param profile 日期对象 Profile
+     * @param belongingObject 对象字段 key，同组子字段都挂在它下面
+     * @param fieldSet 已按 bizType 收好的同组字段
+     */
+    constructor(doc: Doc, profile: DateObjectProfile, belongingObject: string, fieldSet: DateObjectFieldSet);
+    /** 按 bizType 取同组字段 key */
+    fieldByBizType(bizType: FIELD_TYPE): DateObjectChildField | undefined;
+    /** 主表路径 `$.{fieldKey}` */
+    path(bizType: FIELD_TYPE): string | undefined;
+    /** 读取同组字段当前值 */
+    getValue(bizType: FIELD_TYPE): unknown;
+    /** 按 bizType 查找字段 Profile */
+    findFieldProfile(bizType: FIELD_TYPE): DateObjectFieldProfile | undefined;
+    /** 按主表 field key 反查同组 bizType */
+    bizTypeByFieldKey(fieldKey: string | undefined): FIELD_TYPE | undefined;
+    /** 一次模型遍历，收集文档内全部物料日期对象 */
+    static collectAll(doc: Doc): DateObjectContext[];
+    /** 按对象 key 查找上下文；不是日期对象则返回 undefined */
+    static find(doc: Doc, belongingObject: string | undefined): DateObjectContext | undefined;
+}
+export {};

package/dist/domain/object/date-object/runtime/date-object-runtime.d.ts

@@ -0,0 +1,41 @@
+import { Doc } from '../../../../core';
+import { FieldChangeMap } from '../../../../core/data';
+export declare class DateObjectRuntime {
+    private readonly doc;
+    /** 绑定当前文档；每次 overlay / afterFlush 可 new 一份 */
+    constructor(doc: Doc);
+    /** 文档初始化：按当前物料写入批次下拉过滤参数 */
+    onInit(): void;
+    /**
+     * 选中 / 清空下拉：按 profile.fillFromOption、clearOnEmpty 回填。
+     * 只反填物料 / 生产日期 / 有效期；下一次复检日期由 afterFlush 现查接口计算。
+     */
+    buildFillFromOption(options: {
+        belongingObject?: string;
+        bizType?: string;
+        selectedOption?: Record<string, unknown> | null;
+    }): Record<string, unknown>;
+    /**
+     * 用户改上游字段时，按 select.clearOnLinkChange 清空下游。
+     * 只看「本次点选的字段」，避免批次反填物料时把批次自己清掉。
+     */
+    buildDownstreamClears(options: {
+        belongingObject?: string;
+        bizType?: string;
+        pending?: Record<string, unknown>;
+    }): Record<string, unknown>;
+    /**
+     * 用户变更主表字段后：刷新级联 query，并按 profile.rowHandlers 现查接口重算。
+     */
+    onFieldChanges(changedMap: FieldChangeMap, options?: {
+        batchSource?: string;
+    }): Promise<void>;
+    /** 主表路径 `$.fieldKey` → 对象内 bizType */
+    private resolveChangedBizType;
+    /** 批次反填物料时物料值未变，不应触发 clearOnLinkChange */
+    private isUnchangedProduct;
+    /** 按 select.buildLinkQuery 写入批次下拉过滤参数 */
+    private applyLinkage;
+    /** 按 bizType 把同组字段写成 null；批次额外清 _id_ */
+    private buildClearUpdates;
+}

package/dist/domain/object/date-object/runtime/fetch-records.d.ts

@@ -0,0 +1,16 @@
+/** 物料信息：按版本 id 拉一条（value 可能是 baseId:versionId） */
+export declare function fetchProductRecord(productValue: unknown): Promise<Record<string, unknown> | null>;
+/** 批次信息：优先 companion id，否则按批次号 name_ */
+export declare function fetchLotRecord(options: {
+    lotId?: unknown;
+    lotName?: unknown;
+}): Promise<Record<string, unknown> | null>;
+/** 并行拉物料 + 批次；缺 ident 的一侧不请求 */
+export declare function fetchDateObjectRecords(options: {
+    productValue?: unknown;
+    lotId?: unknown;
+    lotName?: unknown;
+}): Promise<{
+    product: Record<string, unknown> | null;
+    lot: Record<string, unknown> | null;
+}>;

package/dist/domain/object/date-object/runtime/object-handlers.d.ts

@@ -0,0 +1,6 @@
+import { Doc } from '../../../../core';
+export type DateObjectHandler = (doc: Doc, belongingObject: string) => void | Promise<void>;
+/** 注册对象级运行时钩子；profile 只需写短名 */
+export declare function registerDateObjectHandler(name: string, handler: DateObjectHandler): void;
+/** 执行指定短名的对象处理器；未注册则静默跳过 */
+export declare function runDateObjectHandler(name: string | undefined, doc: Doc, belongingObject: string): Promise<void>;

package/dist/domain/object/date-object/runtime/re-inspection-date.d.ts

@@ -0,0 +1,49 @@
+import { MISSING_RE_INSPECTION_INTERVAL_MSG } from '../profile/field-keys';
+export { MISSING_RE_INSPECTION_INTERVAL_MSG };
+export type ReInspectionIntervalUnit = 'day' | 'month';
+export interface ReInspectionInterval {
+    /** 复检周期 */
+    amount: number;
+    /** 复检周期单位 */
+    unit: ReInspectionIntervalUnit;
+}
+export interface ResolveNextReInspectionDateInput {
+    /** paramsConfig.txnConfig.businessType === reInspection */
+    isReInspection: boolean;
+    /** 批次接口上的下一次复检日期 */
+    lotReInspectionDate?: unknown;
+    /** 当前生产日期（批次带出或手选） */
+    productionDate?: unknown;
+    /** 复检周期信息 */
+    interval?: ReInspectionInterval;
+}
+export interface ResolveNextReInspectionDateResult {
+    value: string | null;
+    /** 是否走「生产日期 / 接口日期 + 周期」计算 */
+    needCalculate: boolean;
+    missingInterval: boolean;
+}
+/** 是否为可解析的日历日期（写入前会归一成 YYYY-MM-DD） */
+export declare function hasDateValue(value: unknown): boolean;
+/**
+ * 复检周期单位：接口只返回 day / month。
+ */
+export declare function normalizeReInspectionUnit(unit: unknown): ReInspectionIntervalUnit | undefined;
+/** 复检周期数量：必须是有限正数 */
+export declare function parseReInspectionIntervalAmount(value: unknown): number | undefined;
+/** 从物料或批次 option 读取复检周期；缺数量或单位则视为未配置 */
+export declare function pickReInspectionInterval(source?: Record<string, unknown> | null): ReInspectionInterval | undefined;
+/**
+ * 按日历加周期：先 toDateOnly 成 YYYY-MM-DD，再 dayjs.add。
+ * 项目里没有现成的日期加减工具，日期归一复用 toDateOnly。
+ * 自然月：1月31日 + 1月 → 2月28日；无效基准日期返回 null。
+ */
+export declare function addReInspectionInterval(base: unknown, interval: ReInspectionInterval): string | null;
+/**
+ * 下一次复检日期：
+ * - 未配复检且批次已有日期 → 直接用接口值
+ * - 否则用「接口日期（复检场景）或生产日期」+ 周期
+ */
+export declare function resolveNextReInspectionDate(input: ResolveNextReInspectionDateInput): ResolveNextReInspectionDateResult;
+/** paramsConfig.txnConfig.businessType === reInspection */
+export declare function isReInspectionTxnConfig(txnConfig: unknown): boolean;

package/dist/domain/object/date-object/runtime/register-handlers.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/domain/object/date-object/runtime/row-change-handlers.d.ts

@@ -0,0 +1,6 @@
+import { Doc } from '../../../../core';
+/**
+ * 用当前表单上的物料 / 批次去拉接口，写入下一次复检日期。
+ * 物料、批次都空时不请求、不提示（还没选 ident）。
+ */
+export declare function syncReInspectionDate(doc: Doc, belongingObject: string): Promise<void>;

package/dist/domain/object/date-object/types.d.ts

@@ -0,0 +1,48 @@
+import { FIELD_TYPE } from '../../field/field-type';
+/** 单条 option → 对象子字段 的映射 */
+export interface DateObjectOptionFillDef {
+    /** option record 里的源字段 key */
+    optionField: string;
+    /** 目标子字段，运行时按 bizType 解析为实际 field key */
+    toBizType: FIELD_TYPE;
+    /** 写入前对 option 值做转换（如日期时间 → 日期） */
+    transform?: (value: unknown) => unknown;
+}
+/** 下拉级联：上游按 bizType 解析，不写死 field key */
+export interface DateObjectSelectDef {
+    /** 上游字段 bizType（与本字段同属一个 belongingObject） */
+    linkBizType: FIELD_TYPE;
+    /** 构建下拉查询参数；上游为空时返回 {}，批次可独立下拉 */
+    buildLinkQuery?: (ctx: {
+        linkValue: unknown;
+    }) => Record<string, unknown>;
+    /** 用户改上游时清空的下游（bizType） */
+    clearOnLinkChange?: FIELD_TYPE[];
+}
+/** 日期对象子字段 Profile：按 bizType 匹配，声明联动 / 反填 */
+export interface DateObjectFieldProfile {
+    match: {
+        bizType: FIELD_TYPE;
+    };
+    /** 下拉级联 */
+    select?: DateObjectSelectDef;
+    /** 选中下拉项后，从 option 同步填充同组字段 */
+    fillFromOption?: DateObjectOptionFillDef[];
+    /** 本字段清空时要清的 sibling bizType（不含反填物料） */
+    clearOnEmpty?: FIELD_TYPE[];
+}
+/** 对象级处理器声明：按时机调用注册于 object-handlers 的具名处理器 */
+export interface DateObjectRowHandlerDef {
+    when: 'onFieldChange';
+    /** 仅这些 bizType 变更时执行 */
+    watch: FIELD_TYPE[];
+    /** 注册于 object-handlers 的处理器短名 */
+    handler: string;
+}
+/** 物料日期对象 Profile */
+export interface DateObjectProfile {
+    type: 'date_object';
+    fields: DateObjectFieldProfile[];
+    /** 无法声明的副作用（如按物料/批次接口计算复检日期） */
+    rowHandlers?: DateObjectRowHandlerDef[];
+}