@platforma-open/milaboratories.sequence-embeddings 1.4.0 → 1.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/author_marker.d.ts
1
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/author_marker.d.ts
2
2
  //#region src/author_marker.d.ts
3
3
  /** Structure to help resolve conflicts if multiple participants writes to
4
4
  * the same state */
@@ -8,10 +8,11 @@ interface AuthorMarker {
8
8
  authorId: string;
9
9
  /** Sequential version of the state local to the author */
10
10
  localVersion: number;
11
- } //#endregion
11
+ }
12
12
  //#endregion
13
13
  //#region ../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/typeAliases.d.cts
14
14
  type Primitive = string | number | symbol | bigint | boolean | null | undefined;
15
+ type Scalars = Primitive | Primitive[];
15
16
  //#endregion
16
17
  //#region ../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/util.d.cts
17
18
  declare namespace util {
@@ -24,8 +25,8 @@ declare namespace util {
24
25
  export type OmitKeys<T, K extends string> = Pick<T, Exclude<keyof T, K>>;
25
26
  export type MakePartial<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
26
27
  export type Exactly<T, X> = T & Record<Exclude<keyof X, keyof T>, never>;
27
- export type InexactPartial<T> = { [k in keyof T]?: T[k] | undefined };
28
- export const arrayToEnum: <T extends string, U extends [T, ...T[]]>(items: U) => { [k in U[number]]: k };
28
+ export type InexactPartial<T> = { [k in keyof T]?: T[k] | undefined; };
29
+ export const arrayToEnum: <T extends string, U extends [T, ...T[]]>(items: U) => { [k in U[number]]: k; };
29
30
  export const getValidEnumValues: (obj: any) => any[];
30
31
  export const objectValues: (obj: any) => any[];
31
32
  export const objectKeys: ObjectConstructor["keys"];
@@ -39,16 +40,16 @@ declare namespace util {
39
40
  export {};
40
41
  }
41
42
  declare namespace objectUtil {
42
- export type MergeShapes<U, V> = keyof U & keyof V extends never ? U & V : { [k in Exclude<keyof U, keyof V>]: U[k] } & V;
43
- type optionalKeys<T extends object> = { [k in keyof T]: undefined extends T[k] ? k : never }[keyof T];
44
- type requiredKeys<T extends object> = { [k in keyof T]: undefined extends T[k] ? never : k }[keyof T];
45
- export type addQuestionMarks<T extends object, _O = any> = { [K in requiredKeys<T>]: T[K] } & { [K in optionalKeys<T>]?: T[K] } & { [k in keyof T]?: unknown };
43
+ export type MergeShapes<U, V> = keyof U & keyof V extends never ? U & V : { [k in Exclude<keyof U, keyof V>]: U[k]; } & V;
44
+ type optionalKeys<T extends object> = { [k in keyof T]: undefined extends T[k] ? k : never; }[keyof T];
45
+ type requiredKeys<T extends object> = { [k in keyof T]: undefined extends T[k] ? never : k; }[keyof T];
46
+ export type addQuestionMarks<T extends object, _O = any> = { [K in requiredKeys<T>]: T[K]; } & { [K in optionalKeys<T>]?: T[K]; } & { [k in keyof T]?: unknown; };
46
47
  export type identity<T> = T;
47
- export type flatten<T> = identity<{ [k in keyof T]: T[k] }>;
48
- export type noNeverKeys<T> = { [k in keyof T]: [T[k]] extends [never] ? never : k }[keyof T];
49
- export type noNever<T> = identity<{ [k in noNeverKeys<T>]: k extends keyof T ? T[k] : never }>;
48
+ export type flatten<T> = identity<{ [k in keyof T]: T[k]; }>;
49
+ export type noNeverKeys<T> = { [k in keyof T]: [T[k]] extends [never] ? never : k; }[keyof T];
50
+ export type noNever<T> = identity<{ [k in noNeverKeys<T>]: k extends keyof T ? T[k] : never; }>;
50
51
  export const mergeShapes: <U, T>(first: U, second: T) => T & U;
51
- export type extendShape<A extends object, B extends object> = keyof A & keyof B extends never ? A & B : { [K in keyof A as K extends keyof B ? never : K]: A[K] } & { [K in keyof B]: B[K] };
52
+ export type extendShape<A extends object, B extends object> = keyof A & keyof B extends never ? A & B : { [K in keyof A as K extends keyof B ? never : K]: A[K]; } & { [K in keyof B]: B[K]; };
52
53
  export {};
53
54
  }
54
55
  declare const ZodParsedType: {
@@ -74,12 +75,14 @@ declare const ZodParsedType: {
74
75
  set: "set";
75
76
  };
76
77
  type ZodParsedType = keyof typeof ZodParsedType;
78
+ declare const getParsedType: (data: any) => ZodParsedType;
77
79
  //#endregion
78
80
  //#region ../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/ZodError.d.cts
79
81
  type allKeys<T> = T extends any ? keyof T : never;
82
+ type inferFlattenedErrors<T extends ZodType<any, any, any>, U = string> = typeToFlattenedError<TypeOf<T>, U>;
80
83
  type typeToFlattenedError<T, U = string> = {
81
84
  formErrors: U[];
82
- fieldErrors: { [P in allKeys<T>]?: U[] };
85
+ fieldErrors: { [P in allKeys<T>]?: U[]; };
83
86
  };
84
87
  declare const ZodIssueCode: {
85
88
  invalid_type: "invalid_type";
@@ -184,17 +187,22 @@ interface ZodCustomIssue extends ZodIssueBase {
184
187
  [k: string]: any;
185
188
  };
186
189
  }
190
+ type DenormalizedError = {
191
+ [k: string]: DenormalizedError | string[];
192
+ };
187
193
  type ZodIssueOptionalMessage = ZodInvalidTypeIssue | ZodInvalidLiteralIssue | ZodUnrecognizedKeysIssue | ZodInvalidUnionIssue | ZodInvalidUnionDiscriminatorIssue | ZodInvalidEnumValueIssue | ZodInvalidArgumentsIssue | ZodInvalidReturnTypeIssue | ZodInvalidDateIssue | ZodInvalidStringIssue | ZodTooSmallIssue | ZodTooBigIssue | ZodInvalidIntersectionTypesIssue | ZodNotMultipleOfIssue | ZodNotFiniteIssue | ZodCustomIssue;
188
194
  type ZodIssue = ZodIssueOptionalMessage & {
189
195
  fatal?: boolean | undefined;
190
196
  message: string;
191
197
  };
192
- type recursiveZodFormattedError<T> = T extends [any, ...any[]] ? { [K in keyof T]?: ZodFormattedError<T[K]> } : T extends any[] ? {
198
+ declare const quotelessJson: (obj: any) => string;
199
+ type recursiveZodFormattedError<T> = T extends [any, ...any[]] ? { [K in keyof T]?: ZodFormattedError<T[K]>; } : T extends any[] ? {
193
200
  [k: number]: ZodFormattedError<T[number]>;
194
- } : T extends object ? { [K in keyof T]?: ZodFormattedError<T[K]> } : unknown;
201
+ } : T extends object ? { [K in keyof T]?: ZodFormattedError<T[K]>; } : unknown;
195
202
  type ZodFormattedError<T, U = string> = {
196
203
  _errors: U[];
197
204
  } & recursiveZodFormattedError<NonNullable<T>>;
205
+ type inferFormattedError<T extends ZodType<any, any, any>, U = string> = ZodFormattedError<TypeOf<T>, U>;
198
206
  declare class ZodError<T = any> extends Error {
199
207
  issues: ZodIssue[];
200
208
  get errors(): ZodIssue[];
@@ -225,7 +233,20 @@ type ZodErrorMap = (issue: ZodIssueOptionalMessage, _ctx: ErrorMapCtx) => {
225
233
  message: string;
226
234
  };
227
235
  //#endregion
236
+ //#region ../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/locales/en.d.cts
237
+ declare const errorMap: ZodErrorMap;
238
+ //#endregion
239
+ //#region ../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/errors.d.cts
240
+ declare function setErrorMap(map: ZodErrorMap): void;
241
+ declare function getErrorMap(): ZodErrorMap;
242
+ //#endregion
228
243
  //#region ../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/parseUtil.d.cts
244
+ declare const makeIssue: (params: {
245
+ data: any;
246
+ path: (string | number)[];
247
+ errorMaps: ZodErrorMap[];
248
+ issueData: IssueData;
249
+ }) => ZodIssue;
229
250
  type ParseParams = {
230
251
  path: (string | number)[];
231
252
  errorMap: ZodErrorMap;
@@ -233,6 +254,7 @@ type ParseParams = {
233
254
  };
234
255
  type ParsePathComponent = string | number;
235
256
  type ParsePath = ParsePathComponent[];
257
+ declare const EMPTY_PATH: ParsePath;
236
258
  interface ParseContext {
237
259
  readonly common: {
238
260
  readonly issues: ZodIssue[];
@@ -250,6 +272,11 @@ type ParseInput = {
250
272
  path: (string | number)[];
251
273
  parent: ParseContext;
252
274
  };
275
+ declare function addIssueToContext(ctx: ParseContext, issueData: IssueData): void;
276
+ type ObjectPair = {
277
+ key: SyncParseReturnType<any>;
278
+ value: SyncParseReturnType<any>;
279
+ };
253
280
  declare class ParseStatus {
254
281
  value: "aborted" | "dirty" | "valid";
255
282
  dirty(): void;
@@ -265,6 +292,10 @@ declare class ParseStatus {
265
292
  alwaysSet?: boolean;
266
293
  }[]): SyncParseReturnType;
267
294
  }
295
+ interface ParseResult {
296
+ status: "aborted" | "dirty" | "valid";
297
+ data: any;
298
+ }
268
299
  type INVALID = {
269
300
  status: "aborted";
270
301
  };
@@ -282,6 +313,10 @@ declare const OK: <T>(value: T) => OK<T>;
282
313
  type SyncParseReturnType<T = any> = OK<T> | DIRTY<T> | INVALID;
283
314
  type AsyncParseReturnType<T> = Promise<SyncParseReturnType<T>>;
284
315
  type ParseReturnType<T> = SyncParseReturnType<T> | AsyncParseReturnType<T>;
316
+ declare const isAborted: (x: ParseReturnType<any>) => x is INVALID;
317
+ declare const isDirty: <T>(x: ParseReturnType<T>) => x is OK<T> | DIRTY<T>;
318
+ declare const isValid: <T>(x: ParseReturnType<T>) => x is OK<T>;
319
+ declare const isAsync: <T>(x: ParseReturnType<T>) => x is AsyncParseReturnType<T>;
285
320
  //#endregion
286
321
  //#region ../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/enumUtil.d.cts
287
322
  declare namespace enumUtil {
@@ -306,7 +341,7 @@ declare namespace errorUtil {
306
341
  //#endregion
307
342
  //#region ../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/partialUtil.d.cts
308
343
  declare namespace partialUtil {
309
- type DeepPartial<T extends ZodTypeAny> = T extends ZodObject<ZodRawShape> ? ZodObject<{ [k in keyof T["shape"]]: ZodOptional<DeepPartial<T["shape"][k]>> }, T["_def"]["unknownKeys"], T["_def"]["catchall"]> : T extends ZodArray<infer Type, infer Card> ? ZodArray<DeepPartial<Type>, Card> : T extends ZodOptional<infer Type> ? ZodOptional<DeepPartial<Type>> : T extends ZodNullable<infer Type> ? ZodNullable<DeepPartial<Type>> : T extends ZodTuple<infer Items> ? { [k in keyof Items]: Items[k] extends ZodTypeAny ? DeepPartial<Items[k]> : never } extends infer PI ? PI extends ZodTupleItems ? ZodTuple<PI> : never : never : T;
344
+ type DeepPartial<T extends ZodTypeAny> = T extends ZodObject<ZodRawShape> ? ZodObject<{ [k in keyof T["shape"]]: ZodOptional<DeepPartial<T["shape"][k]>>; }, T["_def"]["unknownKeys"], T["_def"]["catchall"]> : T extends ZodArray<infer Type, infer Card> ? ZodArray<DeepPartial<Type>, Card> : T extends ZodOptional<infer Type> ? ZodOptional<DeepPartial<Type>> : T extends ZodNullable<infer Type> ? ZodNullable<DeepPartial<Type>> : T extends ZodTuple<infer Items> ? { [k in keyof Items]: Items[k] extends ZodTypeAny ? DeepPartial<Items[k]> : never; } extends (infer PI) ? PI extends ZodTupleItems ? ZodTuple<PI> : never : never : T;
310
345
  }
311
346
  //#endregion
312
347
  //#region ../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/standard-schema.d.cts
@@ -437,6 +472,10 @@ type RawCreateParams = {
437
472
  message?: string | undefined;
438
473
  description?: string | undefined;
439
474
  } | undefined;
475
+ type ProcessedCreateParams = {
476
+ errorMap?: ZodErrorMap | undefined;
477
+ description?: string | undefined;
478
+ };
440
479
  type SafeParseSuccess<Output> = {
441
480
  success: true;
442
481
  data: Output;
@@ -605,6 +644,11 @@ interface ZodStringDef extends ZodTypeDef {
605
644
  typeName: ZodFirstPartyTypeKind.ZodString;
606
645
  coerce: boolean;
607
646
  }
647
+ declare function datetimeRegex(args: {
648
+ precision?: number | null;
649
+ offset?: boolean;
650
+ local?: boolean;
651
+ }): RegExp;
608
652
  declare class ZodString extends ZodType<string, ZodStringDef, string> {
609
653
  _parse(input: ParseInput): ParseReturnType<string>;
610
654
  protected _regex(regex: RegExp, validation: StringValidation, message?: errorUtil.ErrMessage): ZodEffects<this, string, string>;
@@ -735,6 +779,135 @@ declare class ZodNumber extends ZodType<number, ZodNumberDef, number> {
735
779
  get isInt(): boolean;
736
780
  get isFinite(): boolean;
737
781
  }
782
+ type ZodBigIntCheck = {
783
+ kind: "min";
784
+ value: bigint;
785
+ inclusive: boolean;
786
+ message?: string | undefined;
787
+ } | {
788
+ kind: "max";
789
+ value: bigint;
790
+ inclusive: boolean;
791
+ message?: string | undefined;
792
+ } | {
793
+ kind: "multipleOf";
794
+ value: bigint;
795
+ message?: string | undefined;
796
+ };
797
+ interface ZodBigIntDef extends ZodTypeDef {
798
+ checks: ZodBigIntCheck[];
799
+ typeName: ZodFirstPartyTypeKind.ZodBigInt;
800
+ coerce: boolean;
801
+ }
802
+ declare class ZodBigInt extends ZodType<bigint, ZodBigIntDef, bigint> {
803
+ _parse(input: ParseInput): ParseReturnType<bigint>;
804
+ _getInvalidInput(input: ParseInput): INVALID;
805
+ static create: (params?: RawCreateParams & {
806
+ coerce?: boolean;
807
+ }) => ZodBigInt;
808
+ gte(value: bigint, message?: errorUtil.ErrMessage): ZodBigInt;
809
+ min: (value: bigint, message?: errorUtil.ErrMessage) => ZodBigInt;
810
+ gt(value: bigint, message?: errorUtil.ErrMessage): ZodBigInt;
811
+ lte(value: bigint, message?: errorUtil.ErrMessage): ZodBigInt;
812
+ max: (value: bigint, message?: errorUtil.ErrMessage) => ZodBigInt;
813
+ lt(value: bigint, message?: errorUtil.ErrMessage): ZodBigInt;
814
+ protected setLimit(kind: "min" | "max", value: bigint, inclusive: boolean, message?: string): ZodBigInt;
815
+ _addCheck(check: ZodBigIntCheck): ZodBigInt;
816
+ positive(message?: errorUtil.ErrMessage): ZodBigInt;
817
+ negative(message?: errorUtil.ErrMessage): ZodBigInt;
818
+ nonpositive(message?: errorUtil.ErrMessage): ZodBigInt;
819
+ nonnegative(message?: errorUtil.ErrMessage): ZodBigInt;
820
+ multipleOf(value: bigint, message?: errorUtil.ErrMessage): ZodBigInt;
821
+ get minValue(): bigint | null;
822
+ get maxValue(): bigint | null;
823
+ }
824
+ interface ZodBooleanDef extends ZodTypeDef {
825
+ typeName: ZodFirstPartyTypeKind.ZodBoolean;
826
+ coerce: boolean;
827
+ }
828
+ declare class ZodBoolean extends ZodType<boolean, ZodBooleanDef, boolean> {
829
+ _parse(input: ParseInput): ParseReturnType<boolean>;
830
+ static create: (params?: RawCreateParams & {
831
+ coerce?: boolean;
832
+ }) => ZodBoolean;
833
+ }
834
+ type ZodDateCheck = {
835
+ kind: "min";
836
+ value: number;
837
+ message?: string | undefined;
838
+ } | {
839
+ kind: "max";
840
+ value: number;
841
+ message?: string | undefined;
842
+ };
843
+ interface ZodDateDef extends ZodTypeDef {
844
+ checks: ZodDateCheck[];
845
+ coerce: boolean;
846
+ typeName: ZodFirstPartyTypeKind.ZodDate;
847
+ }
848
+ declare class ZodDate extends ZodType<Date, ZodDateDef, Date> {
849
+ _parse(input: ParseInput): ParseReturnType<this["_output"]>;
850
+ _addCheck(check: ZodDateCheck): ZodDate;
851
+ min(minDate: Date, message?: errorUtil.ErrMessage): ZodDate;
852
+ max(maxDate: Date, message?: errorUtil.ErrMessage): ZodDate;
853
+ get minDate(): Date | null;
854
+ get maxDate(): Date | null;
855
+ static create: (params?: RawCreateParams & {
856
+ coerce?: boolean;
857
+ }) => ZodDate;
858
+ }
859
+ interface ZodSymbolDef extends ZodTypeDef {
860
+ typeName: ZodFirstPartyTypeKind.ZodSymbol;
861
+ }
862
+ declare class ZodSymbol extends ZodType<symbol, ZodSymbolDef, symbol> {
863
+ _parse(input: ParseInput): ParseReturnType<this["_output"]>;
864
+ static create: (params?: RawCreateParams) => ZodSymbol;
865
+ }
866
+ interface ZodUndefinedDef extends ZodTypeDef {
867
+ typeName: ZodFirstPartyTypeKind.ZodUndefined;
868
+ }
869
+ declare class ZodUndefined extends ZodType<undefined, ZodUndefinedDef, undefined> {
870
+ _parse(input: ParseInput): ParseReturnType<this["_output"]>;
871
+ params?: RawCreateParams;
872
+ static create: (params?: RawCreateParams) => ZodUndefined;
873
+ }
874
+ interface ZodNullDef extends ZodTypeDef {
875
+ typeName: ZodFirstPartyTypeKind.ZodNull;
876
+ }
877
+ declare class ZodNull extends ZodType<null, ZodNullDef, null> {
878
+ _parse(input: ParseInput): ParseReturnType<this["_output"]>;
879
+ static create: (params?: RawCreateParams) => ZodNull;
880
+ }
881
+ interface ZodAnyDef extends ZodTypeDef {
882
+ typeName: ZodFirstPartyTypeKind.ZodAny;
883
+ }
884
+ declare class ZodAny extends ZodType<any, ZodAnyDef, any> {
885
+ _any: true;
886
+ _parse(input: ParseInput): ParseReturnType<this["_output"]>;
887
+ static create: (params?: RawCreateParams) => ZodAny;
888
+ }
889
+ interface ZodUnknownDef extends ZodTypeDef {
890
+ typeName: ZodFirstPartyTypeKind.ZodUnknown;
891
+ }
892
+ declare class ZodUnknown extends ZodType<unknown, ZodUnknownDef, unknown> {
893
+ _unknown: true;
894
+ _parse(input: ParseInput): ParseReturnType<this["_output"]>;
895
+ static create: (params?: RawCreateParams) => ZodUnknown;
896
+ }
897
+ interface ZodNeverDef extends ZodTypeDef {
898
+ typeName: ZodFirstPartyTypeKind.ZodNever;
899
+ }
900
+ declare class ZodNever extends ZodType<never, ZodNeverDef, never> {
901
+ _parse(input: ParseInput): ParseReturnType<this["_output"]>;
902
+ static create: (params?: RawCreateParams) => ZodNever;
903
+ }
904
+ interface ZodVoidDef extends ZodTypeDef {
905
+ typeName: ZodFirstPartyTypeKind.ZodVoid;
906
+ }
907
+ declare class ZodVoid extends ZodType<void, ZodVoidDef, void> {
908
+ _parse(input: ParseInput): ParseReturnType<this["_output"]>;
909
+ static create: (params?: RawCreateParams) => ZodVoid;
910
+ }
738
911
  interface ZodArrayDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
739
912
  type: T;
740
913
  typeName: ZodFirstPartyTypeKind.ZodArray;
@@ -762,6 +935,7 @@ declare class ZodArray<T extends ZodTypeAny, Cardinality extends ArrayCardinalit
762
935
  nonempty(message?: errorUtil.ErrMessage): ZodArray<T, "atleastone">;
763
936
  static create: <El extends ZodTypeAny>(schema: El, params?: RawCreateParams) => ZodArray<El>;
764
937
  }
938
+ type ZodNonEmptyArray<T extends ZodTypeAny> = ZodArray<T, "atleastone">;
765
939
  type UnknownKeysParam = "passthrough" | "strict" | "strip";
766
940
  interface ZodObjectDef<T extends ZodRawShape = ZodRawShape, UnknownKeys extends UnknownKeysParam = UnknownKeysParam, Catchall extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
767
941
  typeName: ZodFirstPartyTypeKind.ZodObject;
@@ -769,10 +943,11 @@ interface ZodObjectDef<T extends ZodRawShape = ZodRawShape, UnknownKeys extends
769
943
  catchall: Catchall;
770
944
  unknownKeys: UnknownKeys;
771
945
  }
946
+ type mergeTypes<A, B> = { [k in keyof A | keyof B]: k extends keyof B ? B[k] : k extends keyof A ? A[k] : never; };
772
947
  type objectOutputType<Shape extends ZodRawShape, Catchall extends ZodTypeAny, UnknownKeys extends UnknownKeysParam = UnknownKeysParam> = objectUtil.flatten<objectUtil.addQuestionMarks<baseObjectOutputType<Shape>>> & CatchallOutput<Catchall> & PassthroughType<UnknownKeys>;
773
- type baseObjectOutputType<Shape extends ZodRawShape> = { [k in keyof Shape]: Shape[k]["_output"] };
948
+ type baseObjectOutputType<Shape extends ZodRawShape> = { [k in keyof Shape]: Shape[k]["_output"]; };
774
949
  type objectInputType<Shape extends ZodRawShape, Catchall extends ZodTypeAny, UnknownKeys extends UnknownKeysParam = UnknownKeysParam> = objectUtil.flatten<baseObjectInputType<Shape>> & CatchallInput<Catchall> & PassthroughType<UnknownKeys>;
775
- type baseObjectInputType<Shape extends ZodRawShape> = objectUtil.addQuestionMarks<{ [k in keyof Shape]: Shape[k]["_input"] }>;
950
+ type baseObjectInputType<Shape extends ZodRawShape> = objectUtil.addQuestionMarks<{ [k in keyof Shape]: Shape[k]["_input"]; }>;
776
951
  type CatchallOutput<T extends ZodType> = ZodType extends T ? unknown : {
777
952
  [k: string]: T["_output"];
778
953
  };
@@ -783,6 +958,8 @@ type PassthroughType<T extends UnknownKeysParam> = T extends "passthrough" ? {
783
958
  [k: string]: unknown;
784
959
  } : unknown;
785
960
  type deoptional<T extends ZodTypeAny> = T extends ZodOptional<infer U> ? deoptional<U> : T extends ZodNullable<infer U> ? ZodNullable<deoptional<U>> : T;
961
+ type SomeZodObject = ZodObject<ZodRawShape, UnknownKeysParam, ZodTypeAny>;
962
+ type noUnrecognized<Obj extends object, Shape extends object> = { [k in keyof Obj]: k extends keyof Shape ? Obj[k] : never; };
786
963
  declare class ZodObject<T extends ZodRawShape, UnknownKeys extends UnknownKeysParam = UnknownKeysParam, Catchall extends ZodTypeAny = ZodTypeAny, Output = objectOutputType<T, Catchall, UnknownKeys>, Input = objectInputType<T, Catchall, UnknownKeys>> extends ZodType<Output, ZodObjectDef<T, UnknownKeys, Catchall>, Input> {
787
964
  private _cached;
788
965
  _getCached(): {
@@ -810,18 +987,18 @@ declare class ZodObject<T extends ZodRawShape, UnknownKeys extends UnknownKeysPa
810
987
  * upgrade if you are experiencing issues.
811
988
  */
812
989
  merge<Incoming extends AnyZodObject, Augmentation extends Incoming["shape"]>(merging: Incoming): ZodObject<objectUtil.extendShape<T, Augmentation>, Incoming["_def"]["unknownKeys"], Incoming["_def"]["catchall"]>;
813
- setKey<Key extends string, Schema extends ZodTypeAny>(key: Key, schema: Schema): ZodObject<T & { [k in Key]: Schema }, UnknownKeys, Catchall>;
990
+ setKey<Key extends string, Schema extends ZodTypeAny>(key: Key, schema: Schema): ZodObject<T & { [k in Key]: Schema; }, UnknownKeys, Catchall>;
814
991
  catchall<Index extends ZodTypeAny>(index: Index): ZodObject<T, UnknownKeys, Index>;
815
- pick<Mask extends util.Exactly<{ [k in keyof T]?: true }, Mask>>(mask: Mask): ZodObject<Pick<T, Extract<keyof T, keyof Mask>>, UnknownKeys, Catchall>;
816
- omit<Mask extends util.Exactly<{ [k in keyof T]?: true }, Mask>>(mask: Mask): ZodObject<Omit<T, keyof Mask>, UnknownKeys, Catchall>;
992
+ pick<Mask extends util.Exactly<{ [k in keyof T]?: true; }, Mask>>(mask: Mask): ZodObject<Pick<T, Extract<keyof T, keyof Mask>>, UnknownKeys, Catchall>;
993
+ omit<Mask extends util.Exactly<{ [k in keyof T]?: true; }, Mask>>(mask: Mask): ZodObject<Omit<T, keyof Mask>, UnknownKeys, Catchall>;
817
994
  /**
818
995
  * @deprecated
819
996
  */
820
997
  deepPartial(): partialUtil.DeepPartial<this>;
821
- partial(): ZodObject<{ [k in keyof T]: ZodOptional<T[k]> }, UnknownKeys, Catchall>;
822
- partial<Mask extends util.Exactly<{ [k in keyof T]?: true }, Mask>>(mask: Mask): ZodObject<objectUtil.noNever<{ [k in keyof T]: k extends keyof Mask ? ZodOptional<T[k]> : T[k] }>, UnknownKeys, Catchall>;
823
- required(): ZodObject<{ [k in keyof T]: deoptional<T[k]> }, UnknownKeys, Catchall>;
824
- required<Mask extends util.Exactly<{ [k in keyof T]?: true }, Mask>>(mask: Mask): ZodObject<objectUtil.noNever<{ [k in keyof T]: k extends keyof Mask ? deoptional<T[k]> : T[k] }>, UnknownKeys, Catchall>;
998
+ partial(): ZodObject<{ [k in keyof T]: ZodOptional<T[k]>; }, UnknownKeys, Catchall>;
999
+ partial<Mask extends util.Exactly<{ [k in keyof T]?: true; }, Mask>>(mask: Mask): ZodObject<objectUtil.noNever<{ [k in keyof T]: k extends keyof Mask ? ZodOptional<T[k]> : T[k]; }>, UnknownKeys, Catchall>;
1000
+ required(): ZodObject<{ [k in keyof T]: deoptional<T[k]>; }, UnknownKeys, Catchall>;
1001
+ required<Mask extends util.Exactly<{ [k in keyof T]?: true; }, Mask>>(mask: Mask): ZodObject<objectUtil.noNever<{ [k in keyof T]: k extends keyof Mask ? deoptional<T[k]> : T[k]; }>, UnknownKeys, Catchall>;
825
1002
  keyof(): ZodEnum<enumUtil.UnionToTupleString<keyof T>>;
826
1003
  static create: <Shape extends ZodRawShape>(shape: Shape, params?: RawCreateParams) => ZodObject<Shape, "strip", ZodTypeAny, objectOutputType<Shape, ZodTypeAny, "strip">, objectInputType<Shape, ZodTypeAny, "strip">>;
827
1004
  static strictCreate: <Shape extends ZodRawShape>(shape: Shape, params?: RawCreateParams) => ZodObject<Shape, "strict">;
@@ -838,6 +1015,28 @@ declare class ZodUnion<T extends ZodUnionOptions> extends ZodType<T[number]["_ou
838
1015
  get options(): T;
839
1016
  static create: <Options extends Readonly<[ZodTypeAny, ZodTypeAny, ...ZodTypeAny[]]>>(types: Options, params?: RawCreateParams) => ZodUnion<Options>;
840
1017
  }
1018
+ type ZodDiscriminatedUnionOption<Discriminator extends string> = ZodObject<{ [key in Discriminator]: ZodTypeAny; } & ZodRawShape, UnknownKeysParam, ZodTypeAny>;
1019
+ interface ZodDiscriminatedUnionDef<Discriminator extends string, Options extends readonly ZodDiscriminatedUnionOption<string>[] = ZodDiscriminatedUnionOption<string>[]> extends ZodTypeDef {
1020
+ discriminator: Discriminator;
1021
+ options: Options;
1022
+ optionsMap: Map<Primitive, ZodDiscriminatedUnionOption<any>>;
1023
+ typeName: ZodFirstPartyTypeKind.ZodDiscriminatedUnion;
1024
+ }
1025
+ declare class ZodDiscriminatedUnion<Discriminator extends string, Options extends readonly ZodDiscriminatedUnionOption<Discriminator>[]> extends ZodType<output<Options[number]>, ZodDiscriminatedUnionDef<Discriminator, Options>, input<Options[number]>> {
1026
+ _parse(input: ParseInput): ParseReturnType<this["_output"]>;
1027
+ get discriminator(): Discriminator;
1028
+ get options(): Options;
1029
+ get optionsMap(): Map<Primitive, ZodDiscriminatedUnionOption<any>>;
1030
+ /**
1031
+ * The constructor of the discriminated union schema. Its behaviour is very similar to that of the normal z.union() constructor.
1032
+ * However, it only allows a union of objects, all of which need to share a discriminator property. This property must
1033
+ * have a different value for each object in the union.
1034
+ * @param discriminator the name of the discriminator property
1035
+ * @param types an array of object schemas
1036
+ * @param params
1037
+ */
1038
+ static create<Discriminator extends string, Types extends readonly [ZodDiscriminatedUnionOption<Discriminator>, ...ZodDiscriminatedUnionOption<Discriminator>[]]>(discriminator: Discriminator, options: Types, params?: RawCreateParams): ZodDiscriminatedUnion<Discriminator, Types>;
1039
+ }
841
1040
  interface ZodIntersectionDef<T extends ZodTypeAny = ZodTypeAny, U extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
842
1041
  left: T;
843
1042
  right: U;
@@ -849,21 +1048,98 @@ declare class ZodIntersection<T extends ZodTypeAny, U extends ZodTypeAny> extend
849
1048
  }
850
1049
  type ZodTupleItems = [ZodTypeAny, ...ZodTypeAny[]];
851
1050
  type AssertArray<T> = T extends any[] ? T : never;
852
- type OutputTypeOfTuple<T extends ZodTupleItems | []> = AssertArray<{ [k in keyof T]: T[k] extends ZodType<any, any, any> ? T[k]["_output"] : never }>;
1051
+ type OutputTypeOfTuple<T extends ZodTupleItems | []> = AssertArray<{ [k in keyof T]: T[k] extends ZodType<any, any, any> ? T[k]["_output"] : never; }>;
853
1052
  type OutputTypeOfTupleWithRest<T extends ZodTupleItems | [], Rest extends ZodTypeAny | null = null> = Rest extends ZodTypeAny ? [...OutputTypeOfTuple<T>, ...Rest["_output"][]] : OutputTypeOfTuple<T>;
854
- type InputTypeOfTuple<T extends ZodTupleItems | []> = AssertArray<{ [k in keyof T]: T[k] extends ZodType<any, any, any> ? T[k]["_input"] : never }>;
1053
+ type InputTypeOfTuple<T extends ZodTupleItems | []> = AssertArray<{ [k in keyof T]: T[k] extends ZodType<any, any, any> ? T[k]["_input"] : never; }>;
855
1054
  type InputTypeOfTupleWithRest<T extends ZodTupleItems | [], Rest extends ZodTypeAny | null = null> = Rest extends ZodTypeAny ? [...InputTypeOfTuple<T>, ...Rest["_input"][]] : InputTypeOfTuple<T>;
856
1055
  interface ZodTupleDef<T extends ZodTupleItems | [] = ZodTupleItems, Rest extends ZodTypeAny | null = null> extends ZodTypeDef {
857
1056
  items: T;
858
1057
  rest: Rest;
859
1058
  typeName: ZodFirstPartyTypeKind.ZodTuple;
860
1059
  }
1060
+ type AnyZodTuple = ZodTuple<[ZodTypeAny, ...ZodTypeAny[]] | [], ZodTypeAny | null>;
861
1061
  declare class ZodTuple<T extends ZodTupleItems | [] = ZodTupleItems, Rest extends ZodTypeAny | null = null> extends ZodType<OutputTypeOfTupleWithRest<T, Rest>, ZodTupleDef<T, Rest>, InputTypeOfTupleWithRest<T, Rest>> {
862
1062
  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
863
1063
  get items(): T;
864
1064
  rest<RestSchema extends ZodTypeAny>(rest: RestSchema): ZodTuple<T, RestSchema>;
865
1065
  static create: <Items extends [ZodTypeAny, ...ZodTypeAny[]] | []>(schemas: Items, params?: RawCreateParams) => ZodTuple<Items, null>;
866
1066
  }
1067
+ interface ZodRecordDef<Key extends KeySchema = ZodString, Value extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
1068
+ valueType: Value;
1069
+ keyType: Key;
1070
+ typeName: ZodFirstPartyTypeKind.ZodRecord;
1071
+ }
1072
+ type KeySchema = ZodType<string | number | symbol, any, any>;
1073
+ type RecordType<K extends string | number | symbol, V> = [string] extends [K] ? Record<K, V> : [number] extends [K] ? Record<K, V> : [symbol] extends [K] ? Record<K, V> : [BRAND<string | number | symbol>] extends [K] ? Record<K, V> : Partial<Record<K, V>>;
1074
+ declare class ZodRecord<Key extends KeySchema = ZodString, Value extends ZodTypeAny = ZodTypeAny> extends ZodType<RecordType<Key["_output"], Value["_output"]>, ZodRecordDef<Key, Value>, RecordType<Key["_input"], Value["_input"]>> {
1075
+ get keySchema(): Key;
1076
+ get valueSchema(): Value;
1077
+ _parse(input: ParseInput): ParseReturnType<this["_output"]>;
1078
+ get element(): Value;
1079
+ static create<Value extends ZodTypeAny>(valueType: Value, params?: RawCreateParams): ZodRecord<ZodString, Value>;
1080
+ static create<Keys extends KeySchema, Value extends ZodTypeAny>(keySchema: Keys, valueType: Value, params?: RawCreateParams): ZodRecord<Keys, Value>;
1081
+ }
1082
+ interface ZodMapDef<Key extends ZodTypeAny = ZodTypeAny, Value extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
1083
+ valueType: Value;
1084
+ keyType: Key;
1085
+ typeName: ZodFirstPartyTypeKind.ZodMap;
1086
+ }
1087
+ declare class ZodMap<Key extends ZodTypeAny = ZodTypeAny, Value extends ZodTypeAny = ZodTypeAny> extends ZodType<Map<Key["_output"], Value["_output"]>, ZodMapDef<Key, Value>, Map<Key["_input"], Value["_input"]>> {
1088
+ get keySchema(): Key;
1089
+ get valueSchema(): Value;
1090
+ _parse(input: ParseInput): ParseReturnType<this["_output"]>;
1091
+ static create: <KeySchema extends ZodTypeAny = ZodTypeAny, ValueSchema extends ZodTypeAny = ZodTypeAny>(keyType: KeySchema, valueType: ValueSchema, params?: RawCreateParams) => ZodMap<KeySchema, ValueSchema>;
1092
+ }
1093
+ interface ZodSetDef<Value extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
1094
+ valueType: Value;
1095
+ typeName: ZodFirstPartyTypeKind.ZodSet;
1096
+ minSize: {
1097
+ value: number;
1098
+ message?: string | undefined;
1099
+ } | null;
1100
+ maxSize: {
1101
+ value: number;
1102
+ message?: string | undefined;
1103
+ } | null;
1104
+ }
1105
+ declare class ZodSet<Value extends ZodTypeAny = ZodTypeAny> extends ZodType<Set<Value["_output"]>, ZodSetDef<Value>, Set<Value["_input"]>> {
1106
+ _parse(input: ParseInput): ParseReturnType<this["_output"]>;
1107
+ min(minSize: number, message?: errorUtil.ErrMessage): this;
1108
+ max(maxSize: number, message?: errorUtil.ErrMessage): this;
1109
+ size(size: number, message?: errorUtil.ErrMessage): this;
1110
+ nonempty(message?: errorUtil.ErrMessage): ZodSet<Value>;
1111
+ static create: <ValueSchema extends ZodTypeAny = ZodTypeAny>(valueType: ValueSchema, params?: RawCreateParams) => ZodSet<ValueSchema>;
1112
+ }
1113
+ interface ZodFunctionDef<Args extends ZodTuple<any, any> = ZodTuple<any, any>, Returns extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
1114
+ args: Args;
1115
+ returns: Returns;
1116
+ typeName: ZodFirstPartyTypeKind.ZodFunction;
1117
+ }
1118
+ type OuterTypeOfFunction<Args extends ZodTuple<any, any>, Returns extends ZodTypeAny> = Args["_input"] extends Array<any> ? (...args: Args["_input"]) => Returns["_output"] : never;
1119
+ type InnerTypeOfFunction<Args extends ZodTuple<any, any>, Returns extends ZodTypeAny> = Args["_output"] extends Array<any> ? (...args: Args["_output"]) => Returns["_input"] : never;
1120
+ declare class ZodFunction<Args extends ZodTuple<any, any>, Returns extends ZodTypeAny> extends ZodType<OuterTypeOfFunction<Args, Returns>, ZodFunctionDef<Args, Returns>, InnerTypeOfFunction<Args, Returns>> {
1121
+ _parse(input: ParseInput): ParseReturnType<any>;
1122
+ parameters(): Args;
1123
+ returnType(): Returns;
1124
+ args<Items extends Parameters<(typeof ZodTuple)["create"]>[0]>(...items: Items): ZodFunction<ZodTuple<Items, ZodUnknown>, Returns>;
1125
+ returns<NewReturnType extends ZodType<any, any, any>>(returnType: NewReturnType): ZodFunction<Args, NewReturnType>;
1126
+ implement<F extends InnerTypeOfFunction<Args, Returns>>(func: F): ReturnType<F> extends Returns["_output"] ? (...args: Args["_input"]) => ReturnType<F> : OuterTypeOfFunction<Args, Returns>;
1127
+ strictImplement(func: InnerTypeOfFunction<Args, Returns>): InnerTypeOfFunction<Args, Returns>;
1128
+ validate: <F extends InnerTypeOfFunction<Args, Returns>>(func: F) => ReturnType<F> extends Returns["_output"] ? (...args: Args["_input"]) => ReturnType<F> : OuterTypeOfFunction<Args, Returns>;
1129
+ static create(): ZodFunction<ZodTuple<[], ZodUnknown>, ZodUnknown>;
1130
+ static create<T extends AnyZodTuple = ZodTuple<[], ZodUnknown>>(args: T): ZodFunction<T, ZodUnknown>;
1131
+ static create<T extends AnyZodTuple, U extends ZodTypeAny>(args: T, returns: U): ZodFunction<T, U>;
1132
+ static create<T extends AnyZodTuple = ZodTuple<[], ZodUnknown>, U extends ZodTypeAny = ZodUnknown>(args: T, returns: U, params?: RawCreateParams): ZodFunction<T, U>;
1133
+ }
1134
+ interface ZodLazyDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
1135
+ getter: () => T;
1136
+ typeName: ZodFirstPartyTypeKind.ZodLazy;
1137
+ }
1138
+ declare class ZodLazy<T extends ZodTypeAny> extends ZodType<output<T>, ZodLazyDef<T>, input<T>> {
1139
+ get schema(): T;
1140
+ _parse(input: ParseInput): ParseReturnType<this["_output"]>;
1141
+ static create: <Inner extends ZodTypeAny>(getter: () => Inner, params?: RawCreateParams) => ZodLazy<Inner>;
1142
+ }
867
1143
  interface ZodLiteralDef<T = any> extends ZodTypeDef {
868
1144
  value: T;
869
1145
  typeName: ZodFirstPartyTypeKind.ZodLiteral;
@@ -873,13 +1149,15 @@ declare class ZodLiteral<T> extends ZodType<T, ZodLiteralDef<T>, T> {
873
1149
  get value(): T;
874
1150
  static create: <Value extends Primitive>(value: Value, params?: RawCreateParams) => ZodLiteral<Value>;
875
1151
  }
1152
+ type ArrayKeys = keyof any[];
1153
+ type Indices<T> = Exclude<keyof T, ArrayKeys>;
876
1154
  type EnumValues<T extends string = string> = readonly [T, ...T[]];
877
- type Values<T extends EnumValues> = { [k in T[number]]: k };
1155
+ type Values<T extends EnumValues> = { [k in T[number]]: k; };
878
1156
  interface ZodEnumDef<T extends EnumValues = EnumValues> extends ZodTypeDef {
879
1157
  values: T;
880
1158
  typeName: ZodFirstPartyTypeKind.ZodEnum;
881
1159
  }
882
- type Writeable<T> = { -readonly [P in keyof T]: T[P] };
1160
+ type Writeable<T> = { -readonly [P in keyof T]: T[P]; };
883
1161
  type FilterEnum<Values, ToExclude> = Values extends [] ? [] : Values extends [infer Head, ...infer Rest] ? Head extends ToExclude ? FilterEnum<Rest, ToExclude> : [Head, ...FilterEnum<Rest, ToExclude>] : never;
884
1162
  type typecast<A, T> = A extends T ? A : never;
885
1163
  declare function createZodEnum<U extends string, T extends Readonly<[U, ...U[]]>>(values: T, params?: RawCreateParams): ZodEnum<Writeable<T>>;
@@ -895,6 +1173,20 @@ declare class ZodEnum<T extends [string, ...string[]]> extends ZodType<T[number]
895
1173
  exclude<ToExclude extends readonly [T[number], ...T[number][]]>(values: ToExclude, newDef?: RawCreateParams): ZodEnum<typecast<Writeable<FilterEnum<T, ToExclude[number]>>, [string, ...string[]]>>;
896
1174
  static create: typeof createZodEnum;
897
1175
  }
1176
+ interface ZodNativeEnumDef<T extends EnumLike = EnumLike> extends ZodTypeDef {
1177
+ values: T;
1178
+ typeName: ZodFirstPartyTypeKind.ZodNativeEnum;
1179
+ }
1180
+ type EnumLike = {
1181
+ [k: string]: string | number;
1182
+ [nu: number]: string;
1183
+ };
1184
+ declare class ZodNativeEnum<T extends EnumLike> extends ZodType<T[keyof T], ZodNativeEnumDef<T>, T[keyof T]> {
1185
+ _cache: Set<T[keyof T]> | undefined;
1186
+ _parse(input: ParseInput): ParseReturnType<T[keyof T]>;
1187
+ get enum(): T;
1188
+ static create: <Elements extends EnumLike>(values: Elements, params?: RawCreateParams) => ZodNativeEnum<Elements>;
1189
+ }
898
1190
  interface ZodPromiseDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
899
1191
  type: T;
900
1192
  typeName: ZodFirstPartyTypeKind.ZodPromise;
@@ -904,6 +1196,8 @@ declare class ZodPromise<T extends ZodTypeAny> extends ZodType<Promise<T["_outpu
904
1196
  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
905
1197
  static create: <Inner extends ZodTypeAny>(schema: Inner, params?: RawCreateParams) => ZodPromise<Inner>;
906
1198
  }
1199
+ type Refinement<T> = (arg: T, ctx: RefinementCtx) => any;
1200
+ type SuperRefinement<T> = (arg: T, ctx: RefinementCtx) => void | Promise<void>;
907
1201
  type RefinementEffect<T> = {
908
1202
  type: "refinement";
909
1203
  refinement: (arg: T, ctx: RefinementCtx) => any;
@@ -933,6 +1227,7 @@ interface ZodOptionalDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
933
1227
  innerType: T;
934
1228
  typeName: ZodFirstPartyTypeKind.ZodOptional;
935
1229
  }
1230
+ type ZodOptionalType<T extends ZodTypeAny> = ZodOptional<T>;
936
1231
  declare class ZodOptional<T extends ZodTypeAny> extends ZodType<T["_output"] | undefined, ZodOptionalDef<T>, T["_input"] | undefined> {
937
1232
  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
938
1233
  unwrap(): T;
@@ -942,6 +1237,7 @@ interface ZodNullableDef<T extends ZodTypeAny = ZodTypeAny> extends ZodTypeDef {
942
1237
  innerType: T;
943
1238
  typeName: ZodFirstPartyTypeKind.ZodNullable;
944
1239
  }
1240
+ type ZodNullableType<T extends ZodTypeAny> = ZodNullable<T>;
945
1241
  declare class ZodNullable<T extends ZodTypeAny> extends ZodType<T["_output"] | null, ZodNullableDef<T>, T["_input"] | null> {
946
1242
  _parse(input: ParseInput): ParseReturnType<this["_output"]>;
947
1243
  unwrap(): T;
@@ -974,13 +1270,20 @@ declare class ZodCatch<T extends ZodTypeAny> extends ZodType<T["_output"], ZodCa
974
1270
  catch: Inner["_output"] | (() => Inner["_output"]);
975
1271
  }) => ZodCatch<Inner>;
976
1272
  }
1273
+ interface ZodNaNDef extends ZodTypeDef {
1274
+ typeName: ZodFirstPartyTypeKind.ZodNaN;
1275
+ }
1276
+ declare class ZodNaN extends ZodType<number, ZodNaNDef, number> {
1277
+ _parse(input: ParseInput): ParseReturnType<any>;
1278
+ static create: (params?: RawCreateParams) => ZodNaN;
1279
+ }
977
1280
  interface ZodBrandedDef<T extends ZodTypeAny> extends ZodTypeDef {
978
1281
  type: T;
979
1282
  typeName: ZodFirstPartyTypeKind.ZodBranded;
980
1283
  }
981
1284
  declare const BRAND: unique symbol;
982
1285
  type BRAND<T extends string | number | symbol> = {
983
- [BRAND]: { [k in T]: true };
1286
+ [BRAND]: { [k in T]: true; };
984
1287
  };
985
1288
  declare class ZodBranded<T extends ZodTypeAny, B extends string | number | symbol> extends ZodType<T["_output"] & BRAND<B>, ZodBrandedDef<T>, T["_input"]> {
986
1289
  _parse(input: ParseInput): ParseReturnType<any>;
@@ -1008,6 +1311,24 @@ declare class ZodReadonly<T extends ZodTypeAny> extends ZodType<MakeReadonly<T["
1008
1311
  static create: <Inner extends ZodTypeAny>(type: Inner, params?: RawCreateParams) => ZodReadonly<Inner>;
1009
1312
  unwrap(): T;
1010
1313
  }
1314
+ type CustomParams = CustomErrorParams & {
1315
+ fatal?: boolean;
1316
+ };
1317
+ declare function custom<T>(check?: (data: any) => any, _params?: string | CustomParams | ((input: any) => CustomParams),
1318
+ /**
1319
+ * @deprecated
1320
+ *
1321
+ * Pass `fatal` into the params object instead:
1322
+ *
1323
+ * ```ts
1324
+ * z.string().custom((val) => val.length > 5, { fatal: false })
1325
+ * ```
1326
+ *
1327
+ */
1328
+ fatal?: boolean): ZodType<T, ZodTypeDef, T>;
1329
+ declare const late: {
1330
+ object: <Shape extends ZodRawShape>(shape: () => Shape, params?: RawCreateParams) => ZodObject<Shape, "strip">;
1331
+ };
1011
1332
  declare enum ZodFirstPartyTypeKind {
1012
1333
  ZodString = "ZodString",
1013
1334
  ZodNumber = "ZodNumber",
@@ -1046,6 +1367,69 @@ declare enum ZodFirstPartyTypeKind {
1046
1367
  ZodPipeline = "ZodPipeline",
1047
1368
  ZodReadonly = "ZodReadonly"
1048
1369
  }
1370
+ type ZodFirstPartySchemaTypes = ZodString | ZodNumber | ZodNaN | ZodBigInt | ZodBoolean | ZodDate | ZodUndefined | ZodNull | ZodAny | ZodUnknown | ZodNever | ZodVoid | ZodArray<any, any> | ZodObject<any, any, any> | ZodUnion<any> | ZodDiscriminatedUnion<any, any> | ZodIntersection<any, any> | ZodTuple<any, any> | ZodRecord<any, any> | ZodMap<any> | ZodSet<any> | ZodFunction<any, any> | ZodLazy<any> | ZodLiteral<any> | ZodEnum<any> | ZodEffects<any, any, any> | ZodNativeEnum<any> | ZodOptional<any> | ZodNullable<any> | ZodDefault<any> | ZodCatch<any> | ZodPromise<any> | ZodBranded<any, any> | ZodPipeline<any, any> | ZodReadonly<any> | ZodSymbol;
1371
+ declare abstract class Class {
1372
+ constructor(..._: any[]);
1373
+ }
1374
+ declare const instanceOfType: <T extends typeof Class>(cls: T, params?: CustomParams) => ZodType<InstanceType<T>, ZodTypeDef, InstanceType<T>>;
1375
+ declare const stringType: (params?: RawCreateParams & {
1376
+ coerce?: true;
1377
+ }) => ZodString;
1378
+ declare const numberType: (params?: RawCreateParams & {
1379
+ coerce?: boolean;
1380
+ }) => ZodNumber;
1381
+ declare const nanType: (params?: RawCreateParams) => ZodNaN;
1382
+ declare const bigIntType: (params?: RawCreateParams & {
1383
+ coerce?: boolean;
1384
+ }) => ZodBigInt;
1385
+ declare const booleanType: (params?: RawCreateParams & {
1386
+ coerce?: boolean;
1387
+ }) => ZodBoolean;
1388
+ declare const dateType: (params?: RawCreateParams & {
1389
+ coerce?: boolean;
1390
+ }) => ZodDate;
1391
+ declare const symbolType: (params?: RawCreateParams) => ZodSymbol;
1392
+ declare const undefinedType: (params?: RawCreateParams) => ZodUndefined;
1393
+ declare const nullType: (params?: RawCreateParams) => ZodNull;
1394
+ declare const anyType: (params?: RawCreateParams) => ZodAny;
1395
+ declare const unknownType: (params?: RawCreateParams) => ZodUnknown;
1396
+ declare const neverType: (params?: RawCreateParams) => ZodNever;
1397
+ declare const voidType: (params?: RawCreateParams) => ZodVoid;
1398
+ declare const arrayType: <El extends ZodTypeAny>(schema: El, params?: RawCreateParams) => ZodArray<El>;
1399
+ declare const objectType: <Shape extends ZodRawShape>(shape: Shape, params?: RawCreateParams) => ZodObject<Shape, "strip", ZodTypeAny, objectOutputType<Shape, ZodTypeAny, "strip">, objectInputType<Shape, ZodTypeAny, "strip">>;
1400
+ declare const strictObjectType: <Shape extends ZodRawShape>(shape: Shape, params?: RawCreateParams) => ZodObject<Shape, "strict">;
1401
+ declare const unionType: <Options extends Readonly<[ZodTypeAny, ZodTypeAny, ...ZodTypeAny[]]>>(types: Options, params?: RawCreateParams) => ZodUnion<Options>;
1402
+ declare const discriminatedUnionType: typeof ZodDiscriminatedUnion.create;
1403
+ declare const intersectionType: <TSchema extends ZodTypeAny, USchema extends ZodTypeAny>(left: TSchema, right: USchema, params?: RawCreateParams) => ZodIntersection<TSchema, USchema>;
1404
+ declare const tupleType: <Items extends [ZodTypeAny, ...ZodTypeAny[]] | []>(schemas: Items, params?: RawCreateParams) => ZodTuple<Items, null>;
1405
+ declare const recordType: typeof ZodRecord.create;
1406
+ declare const mapType: <KeySchema extends ZodTypeAny = ZodTypeAny, ValueSchema extends ZodTypeAny = ZodTypeAny>(keyType: KeySchema, valueType: ValueSchema, params?: RawCreateParams) => ZodMap<KeySchema, ValueSchema>;
1407
+ declare const setType: <ValueSchema extends ZodTypeAny = ZodTypeAny>(valueType: ValueSchema, params?: RawCreateParams) => ZodSet<ValueSchema>;
1408
+ declare const functionType: typeof ZodFunction.create;
1409
+ declare const lazyType: <Inner extends ZodTypeAny>(getter: () => Inner, params?: RawCreateParams) => ZodLazy<Inner>;
1410
+ declare const literalType: <Value extends Primitive>(value: Value, params?: RawCreateParams) => ZodLiteral<Value>;
1411
+ declare const enumType: typeof createZodEnum;
1412
+ declare const nativeEnumType: <Elements extends EnumLike>(values: Elements, params?: RawCreateParams) => ZodNativeEnum<Elements>;
1413
+ declare const promiseType: <Inner extends ZodTypeAny>(schema: Inner, params?: RawCreateParams) => ZodPromise<Inner>;
1414
+ declare const effectsType: <I extends ZodTypeAny>(schema: I, effect: Effect<I["_output"]>, params?: RawCreateParams) => ZodEffects<I, I["_output"]>;
1415
+ declare const optionalType: <Inner extends ZodTypeAny>(type: Inner, params?: RawCreateParams) => ZodOptional<Inner>;
1416
+ declare const nullableType: <Inner extends ZodTypeAny>(type: Inner, params?: RawCreateParams) => ZodNullable<Inner>;
1417
+ declare const preprocessType: <I extends ZodTypeAny>(preprocess: (arg: unknown, ctx: RefinementCtx) => unknown, schema: I, params?: RawCreateParams) => ZodEffects<I, I["_output"], unknown>;
1418
+ declare const pipelineType: typeof ZodPipeline.create;
1419
+ declare const ostring: () => ZodOptional<ZodString>;
1420
+ declare const onumber: () => ZodOptional<ZodNumber>;
1421
+ declare const oboolean: () => ZodOptional<ZodBoolean>;
1422
+ declare const coerce: {
1423
+ string: (typeof ZodString)["create"];
1424
+ number: (typeof ZodNumber)["create"];
1425
+ boolean: (typeof ZodBoolean)["create"];
1426
+ bigint: (typeof ZodBigInt)["create"];
1427
+ date: (typeof ZodDate)["create"];
1428
+ };
1429
+ declare const NEVER: never;
1430
+ declare namespace external_d_exports {
1431
+ export { AnyZodObject, AnyZodTuple, ArrayCardinality, ArrayKeys, AssertArray, AsyncParseReturnType, BRAND, CatchallInput, CatchallOutput, CustomErrorParams, DIRTY, DenormalizedError, EMPTY_PATH, Effect, EnumLike, EnumValues, ErrorMapCtx, FilterEnum, INVALID, Indices, InnerTypeOfFunction, InputTypeOfTuple, InputTypeOfTupleWithRest, IpVersion, IssueData, KeySchema, NEVER, OK, ObjectPair, OuterTypeOfFunction, OutputTypeOfTuple, OutputTypeOfTupleWithRest, ParseContext, ParseInput, ParseParams, ParsePath, ParsePathComponent, ParseResult, ParseReturnType, ParseStatus, PassthroughType, PreprocessEffect, Primitive, ProcessedCreateParams, RawCreateParams, RecordType, Refinement, RefinementCtx, RefinementEffect, SafeParseError, SafeParseReturnType, SafeParseSuccess, Scalars, ZodType as Schema, SomeZodObject, StringValidation, SuperRefinement, SyncParseReturnType, TransformEffect, TypeOf, UnknownKeysParam, Values, Writeable, ZodAny, ZodAnyDef, ZodArray, ZodArrayDef, ZodBigInt, ZodBigIntCheck, ZodBigIntDef, ZodBoolean, ZodBooleanDef, ZodBranded, ZodBrandedDef, ZodCatch, ZodCatchDef, ZodCustomIssue, ZodDate, ZodDateCheck, ZodDateDef, ZodDefault, ZodDefaultDef, ZodDiscriminatedUnion, ZodDiscriminatedUnionDef, ZodDiscriminatedUnionOption, ZodEffects, ZodEffectsDef, ZodEnum, ZodEnumDef, ZodError, ZodErrorMap, ZodFirstPartySchemaTypes, ZodFirstPartyTypeKind, ZodFormattedError, ZodFunction, ZodFunctionDef, ZodIntersection, ZodIntersectionDef, ZodInvalidArgumentsIssue, ZodInvalidDateIssue, ZodInvalidEnumValueIssue, ZodInvalidIntersectionTypesIssue, ZodInvalidLiteralIssue, ZodInvalidReturnTypeIssue, ZodInvalidStringIssue, ZodInvalidTypeIssue, ZodInvalidUnionDiscriminatorIssue, ZodInvalidUnionIssue, ZodIssue, ZodIssueBase, ZodIssueCode, ZodIssueOptionalMessage, ZodLazy, ZodLazyDef, ZodLiteral, ZodLiteralDef, ZodMap, ZodMapDef, ZodNaN, ZodNaNDef, ZodNativeEnum, ZodNativeEnumDef, ZodNever, ZodNeverDef, ZodNonEmptyArray, ZodNotFiniteIssue, ZodNotMultipleOfIssue, ZodNull, ZodNullDef, ZodNullable, ZodNullableDef, ZodNullableType, ZodNumber, ZodNumberCheck, ZodNumberDef, ZodObject, ZodObjectDef, ZodOptional, ZodOptionalDef, ZodOptionalType, ZodParsedType, ZodPipeline, ZodPipelineDef, ZodPromise, ZodPromiseDef, ZodRawShape, ZodReadonly, ZodReadonlyDef, ZodRecord, ZodRecordDef, ZodType as ZodSchema, ZodSet, ZodSetDef, ZodString, ZodStringCheck, ZodStringDef, ZodSymbol, ZodSymbolDef, ZodTooBigIssue, ZodTooSmallIssue, ZodEffects as ZodTransformer, ZodTuple, ZodTupleDef, ZodTupleItems, ZodType, ZodTypeAny, ZodTypeDef, ZodUndefined, ZodUndefinedDef, ZodUnion, ZodUnionDef, ZodUnionOptions, ZodUnknown, ZodUnknownDef, ZodUnrecognizedKeysIssue, ZodVoid, ZodVoidDef, addIssueToContext, anyType as any, arrayType as array, arrayOutputType, baseObjectInputType, baseObjectOutputType, bigIntType as bigint, booleanType as boolean, coerce, custom, dateType as date, datetimeRegex, errorMap as defaultErrorMap, deoptional, discriminatedUnionType as discriminatedUnion, effectsType as effect, enumType as enum, functionType as function, getErrorMap, getParsedType, TypeOf as infer, inferFlattenedErrors, inferFormattedError, input, instanceOfType as instanceof, intersectionType as intersection, isAborted, isAsync, isDirty, isValid, late, lazyType as lazy, literalType as literal, makeIssue, mapType as map, mergeTypes, nanType as nan, nativeEnumType as nativeEnum, neverType as never, noUnrecognized, nullType as null, nullableType as nullable, numberType as number, objectType as object, objectInputType, objectOutputType, objectUtil, oboolean, onumber, optionalType as optional, ostring, output, pipelineType as pipeline, preprocessType as preprocess, promiseType as promise, quotelessJson, recordType as record, setType as set, setErrorMap, strictObjectType as strictObject, stringType as string, symbolType as symbol, effectsType as transformer, tupleType as tuple, typeToFlattenedError, typecast, undefinedType as undefined, unionType as union, unknownType as unknown, util, voidType as void };
1432
+ }
1049
1433
  //#endregion
1050
1434
  //#region ../node_modules/.pnpm/@milaboratories+pl-error-like@1.12.10/node_modules/@milaboratories/pl-error-like/dist/error_like_shape.d.ts
1051
1435
  //#region src/error_like_shape.d.ts
@@ -1098,9 +1482,8 @@ type StandardErrorLike = TypeOf<typeof BaseStandardErrorLike> & {
1098
1482
  declare const StandardErrorLike: ZodType<StandardErrorLike>;
1099
1483
  declare const ErrorLike: ZodUnion<[ZodType<StandardErrorLike, ZodTypeDef, StandardErrorLike>, ZodType<PlErrorLike, ZodTypeDef, PlErrorLike>]>;
1100
1484
  type ErrorLike = TypeOf<typeof ErrorLike>;
1101
- /** Converts everything into ErrorLike. */
1102
1485
  //#endregion
1103
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/common_types.d.ts
1486
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/common_types.d.ts
1104
1487
  type OutputWithStatus<T> = {
1105
1488
  ok: true;
1106
1489
  value: T;
@@ -1113,7 +1496,7 @@ type OutputWithStatus<T> = {
1113
1496
  /** Base type for block outputs */
1114
1497
  type BlockOutputsBase = Record<string, OutputWithStatus<unknown>>;
1115
1498
  //#endregion
1116
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/navigation.d.ts
1499
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/navigation.d.ts
1117
1500
  /**
1118
1501
  * Part of the block state, representing current navigation information
1119
1502
  * (i.e. currently selected section)
@@ -1122,14 +1505,14 @@ type NavigationState<Href extends `/${string}` = `/${string}`> = {
1122
1505
  readonly href: Href;
1123
1506
  };
1124
1507
  //#endregion
1125
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/json.d.ts
1508
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/json.d.ts
1126
1509
  //#region src/json.d.ts
1127
1510
  type JsonPrimitive = string | number | boolean | null;
1128
1511
  type JsonValue = JsonPrimitive | JsonValue[] | {
1129
1512
  [key: string]: JsonValue;
1130
1513
  };
1131
1514
  type NotAssignableToJson = bigint | symbol | Function;
1132
- type JsonCompatible<T> = unknown extends T ? unknown : [T] extends [JsonValue] ? T : [T] extends [NotAssignableToJson] ? never : { [P in keyof T]: [Exclude<T[P], undefined>] extends [JsonValue] ? T[P] : [Exclude<T[P], undefined>] extends [NotAssignableToJson] ? never : JsonCompatible<T[P]> };
1515
+ type JsonCompatible<T> = unknown extends T ? unknown : [T] extends [JsonValue] ? T : [T] extends [NotAssignableToJson] ? never : { [P in keyof T]: [Exclude<T[P], undefined>] extends [JsonValue] ? T[P] : [Exclude<T[P], undefined>] extends [NotAssignableToJson] ? never : JsonCompatible<T[P]>; };
1133
1516
  type StringifiedJson<T = unknown> = JsonCompatible<T> extends never ? never : string & {
1134
1517
  __json_stringified: T;
1135
1518
  };
@@ -1137,7 +1520,7 @@ type CanonicalizedJson<T = unknown> = JsonCompatible<T> extends never ? never :
1137
1520
  __json_canonicalized: T;
1138
1521
  };
1139
1522
  //#endregion
1140
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/block_state.d.ts
1523
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/block_state.d.ts
1141
1524
  //#region src/block_state.d.ts
1142
1525
  /**
1143
1526
  * @template Args sets type of block arguments passed to the workflow
@@ -1148,7 +1531,7 @@ type CanonicalizedJson<T = unknown> = JsonCompatible<T> extends never ? never :
1148
1531
  * @template Href typed href to represent navigation state
1149
1532
  */
1150
1533
  type BlockState<Args = unknown, Outputs extends BlockOutputsBase = BlockOutputsBase, UiState = unknown, Href extends `/${string}` = `/${string}`> = {
1151
- /** Block arguments passed to the workflow */args: Args;
1534
+ /** Block arguments passed to the workflow */ args: Args;
1152
1535
  /** UI State persisted in the block state but not passed to the backend
1153
1536
  * template */
1154
1537
  ui: UiState; /** Outputs rendered with block config */
@@ -1157,18 +1540,18 @@ type BlockState<Args = unknown, Outputs extends BlockOutputsBase = BlockOutputsB
1157
1540
  readonly author: AuthorMarker | undefined;
1158
1541
  };
1159
1542
  type BlockStateV3<_Data = unknown, Outputs extends BlockOutputsBase = BlockOutputsBase, Href extends `/${string}` = `/${string}`> = {
1160
- /** Block storage persisted in the block state */blockStorage: StringifiedJson; /** Outputs rendered with block config */
1543
+ /** Block storage persisted in the block state */ blockStorage: StringifiedJson; /** Outputs rendered with block config */
1161
1544
  outputs: Outputs; /** Current navigation state */
1162
1545
  navigationState: NavigationState<Href>;
1163
1546
  readonly author: AuthorMarker | undefined;
1164
- }; //#endregion
1547
+ };
1165
1548
  //#endregion
1166
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/branding.d.ts
1549
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/branding.d.ts
1167
1550
  //#region src/branding.d.ts
1168
- type Brand<B, K extends string = "__pl_model_brand__"> = { [key in K]: B };
1169
- type Branded$1<T, B, K extends string = "__pl_model_brand__"> = T & Brand<B, K>; //#endregion
1551
+ type Brand<B, K extends string = "__pl_model_brand__"> = { [key in K]: B; };
1552
+ type Branded$1<T, B, K extends string = "__pl_model_brand__"> = T & Brand<B, K>;
1170
1553
  //#endregion
1171
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/dialog/index.d.ts
1554
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/dialog/index.d.ts
1172
1555
  //#region src/dialog/index.d.ts
1173
1556
  /**
1174
1557
  * File filter passed to the native save dialog. Matches Electron's
@@ -1199,9 +1582,9 @@ interface ShowSaveDialogResult {
1199
1582
  */
1200
1583
  interface DialogService {
1201
1584
  showSaveDialog(options: ShowSaveDialogOptions): Promise<ShowSaveDialogResult>;
1202
- } //#endregion
1585
+ }
1203
1586
  //#endregion
1204
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/pool_entry.d.ts
1587
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/pool_entry.d.ts
1205
1588
  //#region src/pool_entry.d.ts
1206
1589
  interface PoolEntry<K extends string = string, R extends {} = {}> extends Disposable {
1207
1590
  /** Resource key, calculated using provided `calculateParamsKey` function */
@@ -1215,12 +1598,8 @@ interface PoolEntry<K extends string = string, R extends {} = {}> extends Dispos
1215
1598
  */
1216
1599
  readonly unref: () => void;
1217
1600
  }
1218
- /**
1219
- * Wraps a PoolEntry for use with `using`. Auto-calls `unref()` at end of scope
1220
- * unless `keep()` is called to transfer ownership to the caller.
1221
- */
1222
1601
  //#endregion
1223
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/table_common.d.ts
1602
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/table_common.d.ts
1224
1603
  //#region src/drivers/pframe/table_common.d.ts
1225
1604
  type PTableColumnSpecAxis = {
1226
1605
  type: "axis";
@@ -1251,7 +1630,7 @@ type PTableColumnIdColumn = {
1251
1630
  /** Unified PTable column identifier */
1252
1631
  type PTableColumnId = PTableColumnIdAxis | PTableColumnIdColumn;
1253
1632
  //#endregion
1254
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/data_types.d.ts
1633
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/data_types.d.ts
1255
1634
  //#region src/drivers/pframe/data_types.d.ts
1256
1635
  type PVectorDataInt = Int32Array;
1257
1636
  type PVectorDataLong = BigInt64Array;
@@ -1261,7 +1640,7 @@ type PVectorDataString = (null | string)[];
1261
1640
  type PVectorDataBytes = (null | Uint8Array)[];
1262
1641
  type PVectorDataTyped<DataType extends ValueType> = DataType extends typeof ValueType.Int ? PVectorDataInt : DataType extends typeof ValueType.Long ? PVectorDataLong : DataType extends typeof ValueType.Float ? PVectorDataFloat : DataType extends typeof ValueType.Double ? PVectorDataDouble : DataType extends typeof ValueType.String ? PVectorDataString : DataType extends typeof ValueType.Bytes ? PVectorDataBytes : never;
1263
1642
  type PTableVectorTyped<DataType extends ValueType> = {
1264
- /** Stored data type */readonly type: DataType; /** Values for present positions */
1643
+ /** Stored data type */ readonly type: DataType; /** Values for present positions */
1265
1644
  readonly data: PVectorDataTyped<DataType>;
1266
1645
  /**
1267
1646
  * Encoded bit array marking some elements of this vector as NA,
@@ -1275,22 +1654,33 @@ type PTableVectorTyped<DataType extends ValueType> = {
1275
1654
  type PTableVector = PTableVectorTyped<ValueType>;
1276
1655
  /** Used in requests to partially retrieve table's data */
1277
1656
  type TableRange = {
1278
- /** Index of the first record to retrieve */readonly offset: number; /** Block length */
1657
+ /** Index of the first record to retrieve */ readonly offset: number; /** Block length */
1279
1658
  readonly length: number;
1280
1659
  };
1281
1660
  /** Unified information about table shape */
1282
1661
  type PTableShape = {
1283
- /** Number of unified table columns, including all axes and PColumn values */columns: number; /** Number of rows */
1662
+ /** Number of unified table columns, including all axes and PColumn values */ columns: number; /** Number of rows */
1284
1663
  rows: number;
1285
1664
  };
1286
1665
  /** Supported formats for PTable file download. */
1287
1666
  type PTableDownloadFormat = "csv" | "tsv";
1288
- /** Compression applied to the written file. */
1289
1667
  /** Options for downloading PTable data to a file. */
1290
1668
  interface WritePTableToFsOptions {
1291
1669
  path: string;
1292
1670
  format: PTableDownloadFormat;
1293
1671
  columnIndices: number[];
1672
+ /**
1673
+ * Optional header names aligned 1:1 with {@link columnIndices}. When provided,
1674
+ * each is written verbatim — letting callers supply disambiguated labels the
1675
+ * spec's intrinsic `pl7.app/label` may not carry. When omitted (or an
1676
+ * individual entry is empty), the header falls back to the column's
1677
+ * spec-derived label.
1678
+ *
1679
+ * Additive on purpose: the UI (ui-vue) and the desktop-app runtime version
1680
+ * independently, so a newer UI must not send a shape an older runtime cannot
1681
+ * read. Older runtimes ignore this field and use {@link columnIndices} alone.
1682
+ */
1683
+ headerNames?: string[];
1294
1684
  range?: TableRange;
1295
1685
  chunkSize?: number;
1296
1686
  includeHeader?: boolean;
@@ -1307,11 +1697,6 @@ interface WritePTableToFsResult {
1307
1697
  rowsWritten: number;
1308
1698
  bytesWritten: number;
1309
1699
  }
1310
- /**
1311
- * Maximum number of data rows allowed per sheet in an `xlsx` export, kept below
1312
- * Excel's hard limit of 1,048,576. The driver rejects oversized `xlsx` exports
1313
- * (see {@link PFrameDriver.exportPTable}); UIs use it to gate the `xlsx` option.
1314
- */
1315
1700
  /** Options for {@link PFrameDriver.exportPTable}. */
1316
1701
  interface ExportPTableOptions {
1317
1702
  /** Destination file path; its extension selects the output format
@@ -1320,9 +1705,21 @@ interface ExportPTableOptions {
1320
1705
  /** Unified indices of the columns to export, in output order
1321
1706
  * (axes first, then data columns). */
1322
1707
  columnIndices: number[];
1323
- } //#endregion
1708
+ /**
1709
+ * Optional header names aligned 1:1 with {@link columnIndices}. When provided,
1710
+ * each is written verbatim — letting callers supply disambiguated labels the
1711
+ * spec's intrinsic `pl7.app/label` may not carry. When omitted (or an
1712
+ * individual entry is empty), the header falls back to the column's
1713
+ * spec-derived label.
1714
+ *
1715
+ * Additive on purpose: the UI (ui-vue) and the desktop-app runtime version
1716
+ * independently, so a newer UI must not send a shape an older runtime cannot
1717
+ * read. Older runtimes ignore this field and use {@link columnIndices} alone.
1718
+ */
1719
+ headerNames?: string[];
1720
+ }
1324
1721
  //#endregion
1325
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/data_info.d.ts
1722
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/data_info.d.ts
1326
1723
  //#region src/drivers/pframe/data_info.d.ts
1327
1724
  /**
1328
1725
  * Represents a JavaScript representation of a value in a PColumn. Can be null, a number, or a string.
@@ -1337,16 +1734,12 @@ type PColumnValue = null | number | string;
1337
1734
  * Can be an array of strings or numbers.
1338
1735
  */
1339
1736
  type PColumnKey = (number | string)[];
1340
- /**
1341
- * Represents a single entry in a PColumn's data structure.
1342
- * Contains a key and a value.
1343
- */
1344
1737
  /**
1345
1738
  * Represents column data stored as a simple JSON structure.
1346
1739
  * Used for small datasets that can be efficiently stored directly in memory.
1347
1740
  */
1348
1741
  type JsonDataInfo = {
1349
- /** Identifier for this data format ('Json') */type: "Json"; /** Number of axes that make up the complete key (tuple length) */
1742
+ /** Identifier for this data format ('Json') */ type: "Json"; /** Number of axes that make up the complete key (tuple length) */
1350
1743
  keyLength: number;
1351
1744
  /**
1352
1745
  * Key-value pairs where keys are stringified tuples of axis values
@@ -1359,7 +1752,7 @@ type JsonDataInfo = {
1359
1752
  * Used for larger datasets that need to be split into manageable chunks.
1360
1753
  */
1361
1754
  type JsonPartitionedDataInfo<Blob> = {
1362
- /** Identifier for this data format ('JsonPartitioned') */type: "JsonPartitioned"; /** Number of leading axes used for partitioning */
1755
+ /** Identifier for this data format ('JsonPartitioned') */ type: "JsonPartitioned"; /** Number of leading axes used for partitioning */
1363
1756
  partitionKeyLength: number; /** Map of stringified partition keys to blob references */
1364
1757
  parts: Record<string, Blob>;
1365
1758
  };
@@ -1368,7 +1761,7 @@ type JsonPartitionedDataInfo<Blob> = {
1368
1761
  * Used for efficient storage and retrieval of column data in binary format.
1369
1762
  */
1370
1763
  type BinaryChunk<Blob> = {
1371
- /** Binary blob containing structured index information */index: Blob; /** Binary blob containing the actual values */
1764
+ /** Binary blob containing structured index information */ index: Blob; /** Binary blob containing the actual values */
1372
1765
  values: Blob;
1373
1766
  };
1374
1767
  /**
@@ -1376,12 +1769,12 @@ type BinaryChunk<Blob> = {
1376
1769
  * Optimized for efficient storage and retrieval of large datasets.
1377
1770
  */
1378
1771
  type BinaryPartitionedDataInfo<Blob> = {
1379
- /** Identifier for this data format ('BinaryPartitioned') */type: "BinaryPartitioned"; /** Number of leading axes used for partitioning */
1772
+ /** Identifier for this data format ('BinaryPartitioned') */ type: "BinaryPartitioned"; /** Number of leading axes used for partitioning */
1380
1773
  partitionKeyLength: number; /** Map of stringified partition keys to binary chunks */
1381
1774
  parts: Record<string, BinaryChunk<Blob>>;
1382
1775
  };
1383
1776
  type ParquetPartitionedDataInfo<Blob> = {
1384
- /** Identifier for this data format ('ParquetPartitioned') */type: "ParquetPartitioned"; /** Number of leading axes used for partitioning */
1777
+ /** Identifier for this data format ('ParquetPartitioned') */ type: "ParquetPartitioned"; /** Number of leading axes used for partitioning */
1385
1778
  partitionKeyLength: number; /** Map of stringified partition keys to parquet files */
1386
1779
  parts: Record<string, Blob>;
1387
1780
  };
@@ -1392,12 +1785,6 @@ type ParquetPartitionedDataInfo<Blob> = {
1392
1785
  * @template Blob - Type parameter representing the storage reference type (could be ResourceInfo, PFrameBlobId, etc.)
1393
1786
  */
1394
1787
  type DataInfo<Blob> = JsonDataInfo | JsonPartitionedDataInfo<Blob> | BinaryPartitionedDataInfo<Blob> | ParquetPartitionedDataInfo<Blob>;
1395
- /**
1396
- * Type guard function that checks if the given value is a valid DataInfo.
1397
- *
1398
- * @param value - The value to check
1399
- * @returns True if the value is a valid DataInfo, false otherwise
1400
- */
1401
1788
  /**
1402
1789
  * Represents a single key-value entry in a column's explicit data structure.
1403
1790
  * Used when directly instantiating PColumns with explicit data.
@@ -1411,11 +1798,8 @@ type PColumnValuesEntry = {
1411
1798
  * Used for lightweight explicit instantiation of PColumns.
1412
1799
  */
1413
1800
  type PColumnValues = PColumnValuesEntry[];
1414
- /**
1415
- * Entry-based representation of JsonDataInfo
1416
- */
1417
1801
  //#endregion
1418
- //#region ../node_modules/.pnpm/@milaboratories+helpers@1.14.4/node_modules/@milaboratories/helpers/dist/types/brand.d.ts
1802
+ //#region ../node_modules/.pnpm/@milaboratories+helpers@1.14.5/node_modules/@milaboratories/helpers/dist/types/brand.d.ts
1419
1803
  //#region src/types/brand.d.ts
1420
1804
  /**
1421
1805
  * Phantom-property brand. The key is a plain string literal rather than a
@@ -1437,7 +1821,7 @@ type Branded<T, B> = T & {
1437
1821
  readonly __brand: B;
1438
1822
  };
1439
1823
  //#endregion
1440
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/spec/overridden.d.ts
1824
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/spec/overridden.d.ts
1441
1825
  //#region src/drivers/pframe/spec/overridden.d.ts
1442
1826
  type SpecOverrides = Pick<PColumnSpec, "domain" | "contextDomain" | "annotations"> & {
1443
1827
  axesSpec?: AxisPatches;
@@ -1454,7 +1838,7 @@ interface ColumnOverriddenKey {
1454
1838
  }
1455
1839
  type ColumnOverriddenId = Branded<CanonicalizedJson<ColumnOverriddenKey>, "ColumnOverriddenId">;
1456
1840
  //#endregion
1457
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/query/query_common.d.ts
1841
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/query/query_common.d.ts
1458
1842
  //#region src/drivers/pframe/query/query_common.d.ts
1459
1843
  /**
1460
1844
  * Structural type information for a single column: the axis value types (in
@@ -1462,7 +1846,7 @@ type ColumnOverriddenId = Branded<CanonicalizedJson<ColumnOverriddenKey>, "Colum
1462
1846
  * `typeSpec` shape carried by the data layer (`{ axes, column }`).
1463
1847
  */
1464
1848
  type ColumnTypeSpec = {
1465
- /** List of axis value types defining the dimensions of the data */axes: AxisValueType[]; /** The single column value type */
1849
+ /** List of axis value types defining the dimensions of the data */ axes: AxisValueType[]; /** The single column value type */
1466
1850
  column: ColumnValueType;
1467
1851
  };
1468
1852
  /**
@@ -2149,7 +2533,7 @@ interface QuerySliceAxes<Q, A> {
2149
2533
  input: Q;
2150
2534
  /** List of axis filters to apply (at least one required) */
2151
2535
  axisFilters: {
2152
- /** Axis to filter. `SingleAxisSelector` at the spec layer; axis index at the data layer. */axisSelector: A; /** The constant value to filter the axis to */
2536
+ /** Axis to filter. `SingleAxisSelector` at the spec layer; axis index at the data layer. */ axisSelector: A; /** The constant value to filter the axis to */
2153
2537
  constant: string | number;
2154
2538
  }[];
2155
2539
  }
@@ -2499,9 +2883,9 @@ interface QuerySpecOverride<Q, SO> {
2499
2883
  input: Q;
2500
2884
  /** Spec override patch to overlay on the inner spec. */
2501
2885
  override: SO;
2502
- } //#endregion
2886
+ }
2503
2887
  //#endregion
2504
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/query/query_data.d.ts
2888
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/query/query_data.d.ts
2505
2889
  //#region src/drivers/pframe/query/query_data.d.ts
2506
2890
  /**
2507
2891
  * Column identifier with type specification.
@@ -2510,7 +2894,7 @@ interface QuerySpecOverride<Q, SO> {
2510
2894
  * Used in data layer to carry type information alongside column references.
2511
2895
  */
2512
2896
  type ColumnIdAndTypeSpec = {
2513
- /** Unique identifier of the column */id: PObjectId; /** Type specification defining the axes and the single column value type */
2897
+ /** Unique identifier of the column */ id: PObjectId; /** Type specification defining the axes and the single column value type */
2514
2898
  spec: ColumnTypeSpec;
2515
2899
  };
2516
2900
  /**
@@ -2548,7 +2932,7 @@ type DataQueryOuterJoin = QueryOuterJoin<DataQueryJoinEntry>;
2548
2932
  * - `oneSideAxesIndices` — which axis indices in the joined result to project out
2549
2933
  */
2550
2934
  type DataQueryLinkerJoinLinker = {
2551
- /** Linker column reference. */column: PObjectId; /** Linker's axes mapped into the joined result. */
2935
+ /** Linker column reference. */ column: PObjectId; /** Linker's axes mapped into the joined result. */
2552
2936
  axesMapping: number[]; /** Axis indices (in the joined result) to project out — the linker's one-side axes. */
2553
2937
  oneSideAxesIndices: number[];
2554
2938
  };
@@ -2579,9 +2963,9 @@ type DataExprAxisRef = ExprAxisRef<number>;
2579
2963
  /** @see ExprColumnRef */
2580
2964
  type DataExprColumnRef = ExprColumnRef<number>;
2581
2965
  type DataQueryExpression = DataExprColumnRef | DataExprAxisRef | ExprConstant | ExprNumericBinary<DataQueryExpression> | ExprNumericComparison<DataQueryExpression> | ExprNumericUnary<DataQueryExpression> | ExprStringEquals<DataQueryExpression> | ExprStringContains<DataQueryExpression> | ExprStringRegex<DataQueryExpression> | ExprStringContainsFuzzy<DataQueryExpression> | ExprIsNull<DataQueryExpression> | ExprFillNull<DataQueryExpression> | ExprLogicalUnary<DataQueryExpression> | ExprLogicalVariadic<DataQueryExpression> | ExprIsIn<DataQueryExpression, string> | ExprIsIn<DataQueryExpression, number> | ExprCast<DataQueryExpression> | ExprConditional<DataQueryExpression> | ExprRanking<DataQueryExpression, number, number>;
2582
- type DataQueryBooleanExpression = InferBooleanExpressionUnion<DataQueryExpression>; //#endregion
2966
+ type DataQueryBooleanExpression = InferBooleanExpressionUnion<DataQueryExpression>;
2583
2967
  //#endregion
2584
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/spec_driver.d.ts
2968
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/spec_driver.d.ts
2585
2969
  //#region src/drivers/pframe/spec_driver.d.ts
2586
2970
  /** Matches a string value either exactly or by regex pattern */
2587
2971
  type StringMatcher = {
@@ -2692,7 +3076,7 @@ type DiscoverColumnsStepInfo = DiscoverColumnsLinkerStep | DiscoverColumnsFilter
2692
3076
  * propagate into the inner query.
2693
3077
  */
2694
3078
  type BuildQueryInput = {
2695
- /** Shape version marker — bumped only on breaking structural changes. */readonly version: "v1"; /** Terminal column id — the column actually returning data. */
3079
+ /** Shape version marker — bumped only on breaking structural changes. */ readonly version: "v1"; /** Terminal column id — the column actually returning data. */
2696
3080
  readonly column: PObjectId; /** Ordered path from source integration to `column`. Outermost first. */
2697
3081
  readonly path?: DiscoverColumnsStepInfo[]; /** Axis qualifications attached to the resulting join entry. */
2698
3082
  readonly qualifications?: AxisQualification[];
@@ -2794,9 +3178,9 @@ interface PFrameSpecDriver {
2794
3178
  tableSpec: PTableColumnSpec[];
2795
3179
  filters: PTableRecordFilter[];
2796
3180
  }): DataQueryBooleanExpression[];
2797
- } //#endregion
3181
+ }
2798
3182
  //#endregion
2799
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/spec/selectors.d.ts
3183
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/spec/selectors.d.ts
2800
3184
  /** Single axis selector */
2801
3185
  interface SingleAxisSelector {
2802
3186
  /** Axis name (required) */
@@ -2817,12 +3201,8 @@ interface AxisQualification {
2817
3201
  /** Additional context domain entries applied to the axis. */
2818
3202
  readonly contextDomain: Record<string, string>;
2819
3203
  }
2820
- /**
2821
- * Reference to an axis by its numerical index within the anchor column's axes array
2822
- * Format: [anchorId, axisIndex]
2823
- */
2824
3204
  //#endregion
2825
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/query/query_spec.d.ts
3205
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/query/query_spec.d.ts
2826
3206
  //#region src/drivers/pframe/query/query_spec.d.ts
2827
3207
  /**
2828
3208
  * Join entry for spec-layer queries — the base join entry extended with
@@ -2836,7 +3216,7 @@ interface AxisQualification {
2836
3216
  */
2837
3217
  type SpecQueryJoinEntry<C = ColumnUniversalId> = QueryJoinEntry<SpecQuery<C>> & {
2838
3218
  qualifications?: readonly {
2839
- /** Axis to qualify. */axis: SingleAxisSelector; /** Additional domain constraints for this axis. */
3219
+ /** Axis to qualify. */ axis: SingleAxisSelector; /** Additional domain constraints for this axis. */
2840
3220
  contextDomain: Domain;
2841
3221
  }[];
2842
3222
  };
@@ -2889,9 +3269,9 @@ type SpecExprAxisRef = ExprAxisRef<SingleAxisSelector>;
2889
3269
  /** @see ExprColumnRef */
2890
3270
  type SpecExprColumnRef = ExprColumnRef<ColumnUniversalId>;
2891
3271
  type SpecQueryExpression = SpecExprColumnRef | SpecExprAxisRef | ExprConstant | ExprNumericBinary<SpecQueryExpression> | ExprNumericComparison<SpecQueryExpression> | ExprNumericUnary<SpecQueryExpression> | ExprStringEquals<SpecQueryExpression> | ExprStringContains<SpecQueryExpression> | ExprStringRegex<SpecQueryExpression> | ExprStringContainsFuzzy<SpecQueryExpression> | ExprIsNull<SpecQueryExpression> | ExprFillNull<SpecQueryExpression> | ExprLogicalUnary<SpecQueryExpression> | ExprLogicalVariadic<SpecQueryExpression> | ExprIsIn<SpecQueryExpression, string> | ExprIsIn<SpecQueryExpression, number> | ExprCast<SpecQueryExpression> | ExprConditional<SpecQueryExpression> | ExprRanking<SpecQueryExpression, SingleAxisSelector, PObjectId>;
2892
- type SpecQueryBooleanExpression = InferBooleanExpressionUnion<SpecQueryExpression>; //#endregion
3272
+ type SpecQueryBooleanExpression = InferBooleanExpressionUnion<SpecQueryExpression>;
2893
3273
  //#endregion
2894
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/table_calculate.d.ts
3274
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/table_calculate.d.ts
2895
3275
  //#region src/drivers/pframe/table_calculate.d.ts
2896
3276
  /** Defines a terminal column node in the join request tree */
2897
3277
  interface ColumnJoinEntry<Col> {
@@ -3145,7 +3525,7 @@ interface PTableRecordSingleValueFilterV2 {
3145
3525
  type PTableRecordFilter = PTableRecordSingleValueFilterV2;
3146
3526
  /** Sorting parameters for a PTable. */
3147
3527
  type PTableSorting = {
3148
- /** Unified column identifier */readonly column: PTableColumnId; /** Sorting order */
3528
+ /** Unified column identifier */ readonly column: PTableColumnId; /** Sorting order */
3149
3529
  readonly ascending: boolean; /** Sorting in respect to NA and absent values */
3150
3530
  readonly naAndAbsentAreLeastValues: boolean;
3151
3531
  };
@@ -3167,14 +3547,14 @@ interface PTableDefV2<Col> {
3167
3547
  }
3168
3548
  /** Request to create and retrieve entirety of data of PTable. */
3169
3549
  type CalculateTableDataRequest<Col> = {
3170
- /** Join tree to populate the PTable */readonly src: JoinEntry<Col>; /** Record filters */
3550
+ /** Join tree to populate the PTable */ readonly src: JoinEntry<Col>; /** Record filters */
3171
3551
  readonly filters: PTableRecordFilter[]; /** Table sorting */
3172
3552
  readonly sorting: PTableSorting[];
3173
3553
  };
3174
3554
  /** Response for {@link CalculateTableDataRequest} */
3175
3555
  type CalculateTableDataResponse = FullPTableColumnData[];
3176
3556
  //#endregion
3177
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/ref.d.ts
3557
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/ref.d.ts
3178
3558
  //#region src/ref.d.ts
3179
3559
  declare const PlRef: ZodReadonly<ZodObject<{
3180
3560
  __isRef: ZodLiteral<true>;
@@ -3193,13 +3573,12 @@ declare const PlRef: ZodReadonly<ZodObject<{
3193
3573
  requireEnrichments?: true | undefined;
3194
3574
  }>>;
3195
3575
  type PlRef = TypeOf<typeof PlRef>;
3196
- /** @deprecated use {@link PlRef} */
3197
3576
  //#endregion
3198
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/pool/spec.d.ts
3577
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/pool/spec.d.ts
3199
3578
  //#region src/pool/spec.d.ts
3200
3579
  /** Any object exported into the result pool by the block always have spec attached to it */
3201
3580
  type PObjectSpec = {
3202
- /** PObject kind discriminator */readonly kind: string; /** Name is common part of PObject identity */
3581
+ /** PObject kind discriminator */ readonly kind: string; /** Name is common part of PObject identity */
3203
3582
  readonly name: string; /** Domain is a set of key-value pairs that can be used to identify the object */
3204
3583
  readonly domain?: Record<string, string>;
3205
3584
  /** Context domain provides additional axis/column identity that is matched
@@ -3230,7 +3609,7 @@ interface PObject<Data> {
3230
3609
  readonly data: Data;
3231
3610
  }
3232
3611
  //#endregion
3233
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/spec/spec.d.ts
3612
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/spec/spec.d.ts
3234
3613
  //#region src/drivers/pframe/spec/spec.d.ts
3235
3614
  declare const ValueType: {
3236
3615
  readonly Int: "Int";
@@ -3271,7 +3650,7 @@ type Domain = Metadata & Partial<{
3271
3650
  * all the axes specified in the column spec.
3272
3651
  */
3273
3652
  type AxisSpec = {
3274
- /** Type of the axis value. Should not use non-key types like float or double. */readonly type: AxisValueType; /** Name of the axis */
3653
+ /** Type of the axis value. Should not use non-key types like float or double. */ readonly type: AxisValueType; /** Name of the axis */
3275
3654
  readonly name: string;
3276
3655
  /** Adds auxiliary information to the axis name, type and parents to form a
3277
3656
  * unique identifier */
@@ -3302,7 +3681,6 @@ type AxisSpec = {
3302
3681
  */
3303
3682
  readonly parentAxes?: number[];
3304
3683
  };
3305
- /** Parents are specs, not indexes; normalized axis can be used considering its parents independently from column */
3306
3684
  /** Common type representing spec for all the axes in a column */
3307
3685
  type AxesSpec = AxisSpec[];
3308
3686
  /**
@@ -3343,10 +3721,9 @@ type PUniversalColumnSpec = PObjectSpec & {
3343
3721
  * basic tabular data.
3344
3722
  */
3345
3723
  type PDataColumnSpec = PUniversalColumnSpec & {
3346
- /** Type of column values */readonly valueType: ValueType;
3724
+ /** Type of column values */ readonly valueType: ValueType;
3347
3725
  };
3348
3726
  type PColumnSpec = PDataColumnSpec;
3349
- /** Unique PColumnSpec identifier */
3350
3727
  interface PColumn<Data> extends PObject<Data> {
3351
3728
  /** PColumn spec, allowing it to be found among other PObjects */
3352
3729
  readonly spec: PColumnSpec;
@@ -3359,7 +3736,6 @@ interface PColumnIdAndSpec {
3359
3736
  /** Column spec */
3360
3737
  readonly spec: PColumnSpec;
3361
3738
  }
3362
- /** Get column id and spec from a column */
3363
3739
  interface AxisId {
3364
3740
  /** Type of the axis or column value. For an axis should not use non-key
3365
3741
  * types like float or double. */
@@ -3375,15 +3751,13 @@ interface AxisId {
3375
3751
  }
3376
3752
  /** Array of axis ids */
3377
3753
  type AxesId = AxisId[];
3378
- /** Extracts axis ids from axis spec */
3379
3754
  //#endregion
3380
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/spec/filtered_column.d.ts
3755
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/spec/filtered_column.d.ts
3381
3756
  //#region src/drivers/pframe/spec/filtered_column.d.ts
3382
3757
  /** Value of an axis filter */
3383
3758
  type AxisFilterValue = number | string;
3384
3759
  /** Axis filter by index */
3385
3760
  type AxisFilterByIdx = [number, AxisFilterValue];
3386
- /** Axis filter by name */
3387
3761
  /**
3388
3762
  * `source` is either a leaf {@link PObjectId} or a {@link ColumnDiscoveredId}.
3389
3763
  * Filtered never nests inside Filtered (flat-merge invariant), and Filtered is
@@ -3396,7 +3770,7 @@ interface ColumnFilteredKey {
3396
3770
  }
3397
3771
  type ColumnFilteredId = Branded<CanonicalizedJson<ColumnFilteredKey>, "ColumnFilteredId">;
3398
3772
  //#endregion
3399
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/spec/ids.d.ts
3773
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/spec/ids.d.ts
3400
3774
  //#region src/drivers/pframe/spec/ids.d.ts
3401
3775
  /**
3402
3776
  * Per-axis patches keyed by positional index in the base spec's `axesSpec`.
@@ -3408,23 +3782,14 @@ type ColumnFilteredId = Branded<CanonicalizedJson<ColumnFilteredKey>, "ColumnFil
3408
3782
  * A patch at index `>= base.axesSpec.length` appends a new axis at that slot.
3409
3783
  */
3410
3784
  type AxisPatches = Record<number, Partial<AxisSpec>>;
3411
- /**
3412
- * Universal column identifier optionally anchored and optionally filtered.
3413
- * @deprecated use {@link ColumnUniversalKey}
3414
- */
3415
3785
  /**
3416
3786
  * Canonically serialized {@link UniversalPColumnId}.
3417
3787
  * @deprecated use {@link ColumnUniversalId}
3418
3788
  */
3419
3789
  type SUniversalPColumnId = ColumnUniversalId;
3420
3790
  type ColumnUniversalId = LocalPObjectId | GlobalPObjectId | ColumnFilteredId | ColumnDiscoveredId | ColumnOverriddenId;
3421
- /**
3422
- * Canonically serializes a column key to a branded string id. Accepts both
3423
- * the new {@link ColumnUniversalKey} and the deprecated {@link UniversalPColumnId}
3424
- * (anchored / old filtered object form).
3425
- */
3426
3791
  //#endregion
3427
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/spec/discovered_column.d.ts
3792
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/spec/discovered_column.d.ts
3428
3793
  //#region src/drivers/pframe/spec/discovered_column.d.ts
3429
3794
  interface ColumnDiscoveredKey {
3430
3795
  __isDiscovered: true;
@@ -3439,7 +3804,7 @@ type PathItem = {
3439
3804
  column: ColumnUniversalId;
3440
3805
  };
3441
3806
  //#endregion
3442
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/interfaces.d.ts
3807
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/interfaces.d.ts
3443
3808
  //#region src/drivers/interfaces.d.ts
3444
3809
  /**
3445
3810
  * Intended to match web.Blob, node.Blob, node-fetch.Blob, etc.
@@ -3462,9 +3827,9 @@ interface FileLike extends BlobLike {
3462
3827
  readonly lastModified: number;
3463
3828
  /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/name) */
3464
3829
  readonly name: string;
3465
- } //#endregion
3830
+ }
3466
3831
  //#endregion
3467
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/blob.d.ts
3832
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/blob.d.ts
3468
3833
  //#region src/drivers/blob.d.ts
3469
3834
  /** Handle of locally downloaded blob. This handle is issued only after the
3470
3835
  * blob's content is downloaded locally, and ready for quick access. */
@@ -3472,11 +3837,9 @@ type LocalBlobHandle = Branded$1<string, "LocalBlobHandle">;
3472
3837
  /** Handle of remote blob. This handle is issued as soon as the data becomes
3473
3838
  * available on the remote server. */
3474
3839
  type RemoteBlobHandle = Branded$1<string, "RemoteBlobHandle">;
3475
- /** Being configured inside the output structure provides information about
3476
- * blob's content and means to retrieve it when needed. */
3477
3840
  /** Range in bytes, from should be less than to. */
3478
3841
  declare const RangeBytes: ZodObject<{
3479
- /** Included left border. */from: ZodNumber; /** Excluded right border. */
3842
+ /** Included left border. */ from: ZodNumber; /** Excluded right border. */
3480
3843
  to: ZodNumber;
3481
3844
  }, "strip", ZodTypeAny, {
3482
3845
  from: number;
@@ -3495,11 +3858,8 @@ interface BlobDriver {
3495
3858
  */
3496
3859
  getContent(handle: LocalBlobHandle | RemoteBlobHandle, range?: RangeBytes): Promise<Uint8Array>;
3497
3860
  }
3498
- /**
3499
- * Operational metrics of the blob download driver.
3500
- */
3501
3861
  //#endregion
3502
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/log.d.ts
3862
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/log.d.ts
3503
3863
  //#region src/drivers/log.d.ts
3504
3864
  /** Prefix constants — single source of truth for handle format. */
3505
3865
  declare const LIVE_LOG_PREFIX = "log+live://log/";
@@ -3513,38 +3873,29 @@ type ReadyLogHandle = Branded$1<`${typeof READY_LOG_PREFIX}${string}`, "ReadyLog
3513
3873
  /** Handle of logs. This handle should be passed
3514
3874
  * to the driver for retrieving logs. */
3515
3875
  type AnyLogHandle = LiveLogHandle | ReadyLogHandle;
3516
- /** Type guard to check if a value is any kind of log handle. */
3517
3876
  /** Driver to retrieve logs given log handle */
3518
3877
  interface LogsDriver {
3519
- lastLines(/** A handle that was issued previously. */
3520
-
3521
- handle: AnyLogHandle, /** Allows client to limit total data sent from server. */
3522
-
3523
- lineCount: number,
3878
+ lastLines(
3879
+ /** A handle that was issued previously. */
3880
+ handle: AnyLogHandle /** Allows client to limit total data sent from server. */, lineCount: number,
3524
3881
  /** Makes streamer to perform seek operation to given offset before sending the contents.
3525
3882
  * Client can just use the <new_offset> value of the last response from server to continue streaming after reconnection.
3526
3883
  * If undefined, then starts from the end. */
3527
-
3528
3884
  offsetBytes?: number,
3529
3885
  /** Is substring for line search pattern.
3530
3886
  * This option makes controller to send to the client only lines, that
3531
3887
  * have given substring. */
3532
-
3533
3888
  searchStr?: string): Promise<StreamingApiResponse>;
3534
- readText(/** A handle that was issued previously. */
3535
-
3536
- handle: AnyLogHandle, /** Allows client to limit total data sent from server. */
3537
-
3538
- lineCount: number,
3889
+ readText(
3890
+ /** A handle that was issued previously. */
3891
+ handle: AnyLogHandle /** Allows client to limit total data sent from server. */, lineCount: number,
3539
3892
  /** Makes streamer to perform seek operation to given offset before sending the contents.
3540
3893
  * Client can just use the <new_offset> value of the last response from server to continue streaming after reconnection.
3541
3894
  * If undefined of 0, then starts from the beginning. */
3542
-
3543
3895
  offsetBytes?: number,
3544
3896
  /** Is substring for line search pattern.
3545
3897
  * This option makes controller to send to the client only lines, that
3546
3898
  * have given substring. */
3547
-
3548
3899
  searchStr?: string): Promise<StreamingApiResponse>;
3549
3900
  }
3550
3901
  /** Response of the driver.
@@ -3566,7 +3917,7 @@ type StreamingApiResponseHandleOutdated = {
3566
3917
  shouldUpdateHandle: true;
3567
3918
  };
3568
3919
  //#endregion
3569
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/column_filter.d.ts
3920
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/column_filter.d.ts
3570
3921
  //#region src/drivers/pframe/column_filter.d.ts
3571
3922
  /** Allows to search multiple columns in different contexts. */
3572
3923
  interface ColumnFilter {
@@ -3583,9 +3934,9 @@ interface ColumnFilter {
3583
3934
  /** Match requires all the annotations listed here to match corresponding regex
3584
3935
  * pattern. */
3585
3936
  readonly annotationPattern?: Record<string, string>;
3586
- } //#endregion
3937
+ }
3587
3938
  //#endregion
3588
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/find_columns.d.ts
3939
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/find_columns.d.ts
3589
3940
  //#region src/drivers/pframe/find_columns.d.ts
3590
3941
  /**
3591
3942
  * Request to search among existing columns in the PFrame. Two filtering
@@ -3610,9 +3961,9 @@ interface FindColumnsRequest {
3610
3961
  interface FindColumnsResponse {
3611
3962
  /** Array of column ids found using request criteria. */
3612
3963
  readonly hits: PColumnIdAndSpec[];
3613
- } //#endregion
3964
+ }
3614
3965
  //#endregion
3615
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/unique_values.d.ts
3966
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/unique_values.d.ts
3616
3967
  //#region src/drivers/pframe/unique_values.d.ts
3617
3968
  /** Calculate set of unique values for a specific axis for the filtered set of records */
3618
3969
  interface UniqueValuesRequest {
@@ -3630,13 +3981,13 @@ interface UniqueValuesResponse {
3630
3981
  readonly values: PTableVector;
3631
3982
  /** True if limit was reached and response contain non-exhaustive list of values. */
3632
3983
  readonly overflow: boolean;
3633
- } //#endregion
3984
+ }
3634
3985
  //#endregion
3635
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/pframe.d.ts
3986
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/pframe.d.ts
3636
3987
  /** Information required to instantiate a PFrame. */
3637
- type PFrameDef<Col> = Col[]; //#endregion
3988
+ type PFrameDef<Col> = Col[];
3638
3989
  //#endregion
3639
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/driver.d.ts
3990
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/pframe/driver.d.ts
3640
3991
  //#region src/drivers/pframe/driver.d.ts
3641
3992
  /** PFrame handle */
3642
3993
  type PFrameHandle = Branded$1<string, "PFrame">;
@@ -3702,9 +4053,9 @@ interface PFrameDriver {
3702
4053
  * 1,000,000-row per-sheet limit (below Excel's hard cap of 1,048,576).
3703
4054
  */
3704
4055
  exportPTable(handle: PTableHandle, options: ExportPTableOptions): Promise<void>;
3705
- } //#endregion
4056
+ }
3706
4057
  //#endregion
3707
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/ls.d.ts
4058
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/ls.d.ts
3708
4059
  //#region src/drivers/ls.d.ts
3709
4060
  type ImportFileHandleUpload = `upload://upload/${string}`;
3710
4061
  type ImportFileHandleIndex = `index://index/${string}`;
@@ -3716,7 +4067,7 @@ type StorageHandleLocal = `local://${string}`;
3716
4067
  type StorageHandleRemote = `remote://${string}`;
3717
4068
  type StorageHandle = StorageHandleLocal | StorageHandleRemote;
3718
4069
  type StorageEntry = {
3719
- /** Stable machine identifier (e.g. "library", "root", "local"). Used for filtering. */id: string; /** Human-readable display name. */
4070
+ /** Stable machine identifier (e.g. "library", "root", "local"). Used for filtering. */ id: string; /** Human-readable display name. */
3720
4071
  name: string;
3721
4072
  handle: StorageHandle;
3722
4073
  initialFullPath: string;
@@ -3736,11 +4087,11 @@ type LsEntry = {
3736
4087
  handle: ImportFileHandle;
3737
4088
  };
3738
4089
  type OpenDialogFilter = {
3739
- /** Human-readable file type name */readonly name: string; /** File extensions */
4090
+ /** Human-readable file type name */ readonly name: string; /** File extensions */
3740
4091
  readonly extensions: string[];
3741
4092
  };
3742
4093
  type OpenDialogOps = {
3743
- /** Open dialog window title */readonly title?: string; /** Custom label for the confirmation button, when left empty the default label will be used. */
4094
+ /** Open dialog window title */ readonly title?: string; /** Custom label for the confirmation button, when left empty the default label will be used. */
3744
4095
  readonly buttonLabel?: string; /** Limits of file types user can select */
3745
4096
  readonly filters?: OpenDialogFilter[];
3746
4097
  };
@@ -3754,7 +4105,6 @@ type OpenMultipleFilesResponse = {
3754
4105
  * the dialog, field will be undefined. */
3755
4106
  readonly files?: LocalImportFileHandle[];
3756
4107
  };
3757
- /** Can be used to limit request for local file content to a certain bytes range */
3758
4108
  interface LsDriver {
3759
4109
  /** remote and local storages */
3760
4110
  getStorageList(): Promise<StorageEntry[]>;
@@ -3777,9 +4127,8 @@ interface LsDriver {
3777
4127
  /** Saves currently opened block webview as a PDF. */
3778
4128
  exportToPdf?(): Promise<void>;
3779
4129
  }
3780
- /** Gets a file path from an import handle. */
3781
4130
  //#endregion
3782
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/columns/column_selector.d.ts
4131
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/columns/column_selector.d.ts
3783
4132
  //#region src/columns/column_selector.d.ts
3784
4133
  /** Relaxed string matcher input: plain string, single matcher, or array of mixed. */
3785
4134
  type RelaxedStringMatchers = string | StringMatcher | (string | StringMatcher)[];
@@ -3806,7 +4155,7 @@ interface RelaxedColumnSelector {
3806
4155
  /** One or many relaxed column selectors; normalizes to MultiColumnSelector[]. */
3807
4156
  type ColumnSelector = RelaxedColumnSelector | RelaxedColumnSelector[];
3808
4157
  //#endregion
3809
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/columns/discover_columns_options.d.ts
4158
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/columns/discover_columns_options.d.ts
3810
4159
  //#region src/drivers/columns/discover_columns_options.d.ts
3811
4160
  /**
3812
4161
  * Axis matching behaviour applied to `discover` requests.
@@ -3823,7 +4172,6 @@ type MatchingMode = "enrichment" | "related" | "exact";
3823
4172
  * sandbox/host VM bridge unchanged.
3824
4173
  */
3825
4174
  type AnchorEntry = PlRef | PObjectId | PColumnSpec | RelaxedColumnSelector;
3826
- /** Qualifications needed for both already-integrated anchor columns and the hit column. */
3827
4175
  /**
3828
4176
  * Options object accepted by sandbox `discoverColumns()` and by the host
3829
4177
  * `ColumnsCollectionDriver.discover` / `.filter` methods. Pure JSON shape —
@@ -3854,9 +4202,8 @@ type ColumnsDiscoverOptions = DiscoverColumnsOptions;
3854
4202
  * of the filter surface — only `include` / `exclude` / `anchors`.
3855
4203
  */
3856
4204
  type ColumnsFilterOptions = Omit<DiscoverColumnsOptions, "mode" | "maxHops">;
3857
- /** Translate a {@link MatchingMode} into the boolean-flag form the spec driver consumes. */
3858
4205
  //#endregion
3859
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/columns/types.d.ts
4206
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/columns/types.d.ts
3860
4207
  //#region src/columns/types.d.ts
3861
4208
  /**
3862
4209
  * Opaque sandbox/host accessor handle.
@@ -3936,15 +4283,8 @@ interface AccessorLike<Self extends AccessorLike<Self>> {
3936
4283
  /** Decode the data payload as JSON. Returns `undefined` if no data. */
3937
4284
  getDataAsJson<T = unknown>(): T | undefined;
3938
4285
  }
3939
- /**
3940
- * One indexed column — the canonical record produced by every traversal.
3941
- * Carries everything needed to read spec/data/status under a stable id.
3942
- *
3943
- * Generic over the accessor flavour so the same record shape works for both
3944
- * the sandbox `TreeNodeAccessor` and the host `PlTreeNodeAccessor`.
3945
- */
3946
4286
  //#endregion
3947
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/drivers/columns/columns_collection_driver.d.ts
4287
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/drivers/columns/columns_collection_driver.d.ts
3948
4288
  //#region src/drivers/columns/columns_collection_driver.d.ts
3949
4289
  /**
3950
4290
  * Opaque host-owned handle for a `ColumnsCollection` instance. Issued by
@@ -4056,9 +4396,9 @@ interface ColumnsCollectionDriver {
4056
4396
  addSource(handle: CollectionHandle, sources: ReadonlyArray<SerializedColumnsSource>, host: ColumnsCollectionDriverHost): PoolEntry<CollectionHandle>;
4057
4397
  discover(handle: CollectionHandle, options: ColumnsDiscoverOptions, host: ColumnsCollectionDriverHost): PoolEntry<CollectionHandle>;
4058
4398
  filter(handle: CollectionHandle, options: ColumnsFilterOptions, host: ColumnsCollectionDriverHost): PoolEntry<CollectionHandle>;
4059
- } //#endregion
4399
+ }
4060
4400
  //#endregion
4061
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/services/service_types.d.ts
4401
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/services/service_types.d.ts
4062
4402
  //#region src/services/service_types.d.ts
4063
4403
  type ServiceTypesLike<Model = unknown, Ui = unknown, Kind extends ServiceType = ServiceType, ModelHost = Model, UiHost = Ui> = {
4064
4404
  readonly __types?: {
@@ -4081,24 +4421,23 @@ interface ServiceDispatch {
4081
4421
  }
4082
4422
  type TServices = typeof Services;
4083
4423
  type ExtractServiceName<T> = T extends Branded$1<infer N extends string, any> ? N : never;
4084
- /** Model-side service interfaces keyed by service name literal. */
4085
4424
  /** UI-side service interfaces keyed by service name literal. */
4086
- type UiServices$1 = { [K in keyof TServices as ExtractServiceName<TServices[K]>]: InferServiceUi<ServiceBrand<TServices[K]>> };
4425
+ type UiServices$1 = { [K in keyof TServices as ExtractServiceName<TServices[K]>]: InferServiceUi<ServiceBrand<TServices[K]>>; };
4087
4426
  /** Map from Services keys to their unbranded string name literals. */
4088
- type ServiceNameLiterals = { [K in keyof TServices]: ExtractServiceName<TServices[K]> };
4427
+ type ServiceNameLiterals = { [K in keyof TServices]: ExtractServiceName<TServices[K]>; };
4089
4428
  /** Auto-derived requires* feature flags from Services keys. */
4090
- type ServiceRequireFlags = { [K in keyof TServices as `requires${K & string}`]?: boolean };
4429
+ type ServiceRequireFlags = { [K in keyof TServices as `requires${K & string}`]?: boolean; };
4091
4430
  //#endregion
4092
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/services/service_declarations.d.ts
4431
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/services/service_declarations.d.ts
4093
4432
  //#region src/services/service_declarations.d.ts
4094
4433
  declare const Services: {
4095
4434
  PFrameSpec: Branded$1<"pframeSpec", ServiceTypesLike<PFrameSpecDriver, PFrameSpecDriver, "wasm", PFrameSpecDriver, PFrameSpecDriver>>;
4096
4435
  PFrame: Branded$1<"pframe", ServiceTypesLike<PFrameModelDriver<PColumn<string | PColumnValues | DataInfo<string>>>, PFrameDriver, "node", PFrameModelDriver<PColumn<string | PColumnValues | DataInfo<string>>>, PFrameDriver>>;
4097
4436
  Dialog: Branded$1<"dialog", ServiceTypesLike<Record<string, never>, DialogService, "main", Record<string, never>, DialogService>>;
4098
4437
  ColumnsCollection: Branded$1<"columnsCollection", ServiceTypesLike<ColumnsCollectionDriverModel, ColumnsCollectionDriverModel, "wasm", ColumnsCollectionDriver, ColumnsCollectionDriver>>;
4099
- }; //#endregion
4438
+ };
4100
4439
  //#endregion
4101
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/flags/block_flags.d.ts
4440
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/flags/block_flags.d.ts
4102
4441
  /**
4103
4442
  * Known block flags. Flags are set during model compilation, see `BlockModel.create` for more details and for initial values.
4104
4443
  */
@@ -4110,13 +4449,8 @@ type BlockCodeKnownFeatureFlags = {
4110
4449
  readonly requiresCreatePTable?: number;
4111
4450
  readonly requiresPFramesVersion?: number;
4112
4451
  } & ServiceRequireFlags;
4113
- /**
4114
- * Required PFrames version. Bump this in lockstep with the `@milaboratories/pframes-rs-*`
4115
- * version in `pnpm-workspace.yaml` so blocks built against the new SDK refuse to load on
4116
- * older desktop apps.
4117
- */
4118
4452
  //#endregion
4119
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/driver_kit.d.ts
4453
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/driver_kit.d.ts
4120
4454
  //#region src/driver_kit.d.ts
4121
4455
  /** Set of all drivers exposed in UI SDK via the platforma object. */
4122
4456
  interface DriverKit {
@@ -4135,9 +4469,9 @@ interface DriverKit {
4135
4469
  readonly lsDriver: LsDriver;
4136
4470
  /** Driver allowing to interact with PFrames and PTables */
4137
4471
  readonly pFrameDriver: PFrameDriver;
4138
- } //#endregion
4472
+ }
4139
4473
  //#endregion
4140
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/errors.d.ts
4474
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/errors.d.ts
4141
4475
  type ResultOrError<S, F = Error> = {
4142
4476
  value: S;
4143
4477
  error?: undefined;
@@ -4145,7 +4479,7 @@ type ResultOrError<S, F = Error> = {
4145
4479
  error: F;
4146
4480
  };
4147
4481
  //#endregion
4148
- //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.47.1/node_modules/@milaboratories/pl-model-common/dist/utag.d.ts
4482
+ //#region ../node_modules/.pnpm/@milaboratories+pl-model-common@1.48.0/node_modules/@milaboratories/pl-model-common/dist/utag.d.ts
4149
4483
  //#region src/utag.d.ts
4150
4484
  /** Value returned for changing states supporting reactive listening for changes */
4151
4485
  interface ValueWithUTag<V> {
@@ -4162,21 +4496,21 @@ interface ValueWithUTag<V> {
4162
4496
  }
4163
4497
  interface ValueWithUTagAndAuthor<V> extends ValueWithUTag<V> {
4164
4498
  readonly author?: AuthorMarker;
4165
- } //#endregion
4499
+ }
4166
4500
  //#endregion
4167
- //#region ../node_modules/.pnpm/@platforma-sdk+model@1.80.2/node_modules/@platforma-sdk/model/dist/block_state_patch.d.ts
4501
+ //#region ../node_modules/.pnpm/@platforma-sdk+model@1.83.0/node_modules/@platforma-sdk/model/dist/block_state_patch.d.ts
4168
4502
  //#region src/block_state_patch.d.ts
4169
4503
  /** Patch for the structural object */
4170
4504
  type Patch<K, V> = {
4171
- /** Field name to patch */readonly key: K; /** New value for the field */
4505
+ /** Field name to patch */ readonly key: K; /** New value for the field */
4172
4506
  readonly value: V;
4173
4507
  };
4174
4508
  /** Creates union type of all possible shallow patches for the given structure */
4175
- type Unionize<T extends Record<string, unknown>> = { [K in keyof T]: Patch<K, T[K]> }[keyof T];
4509
+ type Unionize<T extends Record<string, unknown>> = { [K in keyof T]: Patch<K, T[K]>; }[keyof T];
4176
4510
  /** Patch for the BlockState, pushed by onStateUpdates method in SDK. */
4177
- type BlockStatePatch<Args = unknown, Outputs extends BlockOutputsBase = BlockOutputsBase, UiState = unknown, Href extends `/${string}` = `/${string}`> = Unionize<BlockState<Args, Outputs, UiState, Href>>; //#endregion
4511
+ type BlockStatePatch<Args = unknown, Outputs extends BlockOutputsBase = BlockOutputsBase, UiState = unknown, Href extends `/${string}` = `/${string}`> = Unionize<BlockState<Args, Outputs, UiState, Href>>;
4178
4512
  //#endregion
4179
- //#region ../node_modules/.pnpm/@platforma-sdk+model@1.80.2/node_modules/@platforma-sdk/model/dist/plugin_handle.d.ts
4513
+ //#region ../node_modules/.pnpm/@platforma-sdk+model@1.83.0/node_modules/@platforma-sdk/model/dist/plugin_handle.d.ts
4180
4514
  //#region src/plugin_handle.d.ts
4181
4515
  /**
4182
4516
  * Phantom-only base type for constraining PluginHandle's type parameter.
@@ -4196,16 +4530,14 @@ interface PluginFactoryLike<Data extends Record<string, unknown> = Record<string
4196
4530
  uiServices: UiServices;
4197
4531
  };
4198
4532
  }
4199
- /** Extract the Data type from a PluginFactoryLike phantom. */
4200
4533
  /**
4201
4534
  * Opaque handle for a plugin instance. Runtime value is the plugin instance ID string.
4202
4535
  * Branded with factory phantom `F` for type-safe data/outputs extraction.
4203
4536
  * Constrained with PluginFactoryLike (not PluginFactory) to avoid variance issues.
4204
4537
  */
4205
4538
  type PluginHandle<F extends PluginFactoryLike = PluginFactoryLike> = Branded<string, F>;
4206
- /** Construct the output key for a plugin output in the block outputs map. */
4207
4539
  //#endregion
4208
- //#region ../node_modules/.pnpm/@platforma-sdk+model@1.80.2/node_modules/@platforma-sdk/model/dist/block_storage.d.ts
4540
+ //#region ../node_modules/.pnpm/@platforma-sdk+model@1.83.0/node_modules/@platforma-sdk/model/dist/block_storage.d.ts
4209
4541
  /** Payload for storage mutation operations. SDK defines specific operations. */
4210
4542
  type MutateStoragePayload<T = unknown> = {
4211
4543
  operation: "update-block-data";
@@ -4215,15 +4547,8 @@ type MutateStoragePayload<T = unknown> = {
4215
4547
  pluginId: PluginHandle;
4216
4548
  value: unknown;
4217
4549
  };
4218
- /**
4219
- * Updates the data in BlockStorage (immutable)
4220
- *
4221
- * @param storage - The current BlockStorage
4222
- * @param payload - The update payload with operation and value
4223
- * @returns A new BlockStorage with updated data
4224
- */
4225
4550
  //#endregion
4226
- //#region ../node_modules/.pnpm/@platforma-sdk+model@1.80.2/node_modules/@platforma-sdk/model/dist/bconfig/lambdas.d.ts
4551
+ //#region ../node_modules/.pnpm/@platforma-sdk+model@1.83.0/node_modules/@platforma-sdk/model/dist/bconfig/lambdas.d.ts
4227
4552
  /** Additional information that may alter lambda rendering procedure. */
4228
4553
  type ConfigRenderLambdaFlags = {
4229
4554
  /**
@@ -4252,15 +4577,14 @@ interface ConfigRenderLambda<Return = unknown> extends ConfigRenderLambdaFlags {
4252
4577
  handle: string;
4253
4578
  }
4254
4579
  type ExtractFunctionHandleReturn<Func extends ConfigRenderLambda> = Func extends ConfigRenderLambda<infer Return> ? Return : never;
4255
- /** Infers the output type from a TypedConfig or ConfigRenderLambda */
4256
4580
  /** Maps lambda-only outputs configuration to inferred output types (for V3 blocks) */
4257
4581
  type InferOutputsFromLambdas<OutputsCfg extends Record<string, ConfigRenderLambda>> = { [Key in keyof OutputsCfg]: OutputWithStatus<ExtractFunctionHandleReturn<OutputsCfg[Key]>> & {
4258
4582
  __unwrap: OutputsCfg[Key] extends {
4259
4583
  withStatus: true;
4260
4584
  } ? false : true;
4261
- } }; //#endregion
4585
+ }; };
4262
4586
  //#endregion
4263
- //#region ../node_modules/.pnpm/@platforma-sdk+model@1.80.2/node_modules/@platforma-sdk/model/dist/block_api_v1.d.ts
4587
+ //#region ../node_modules/.pnpm/@platforma-sdk+model@1.83.0/node_modules/@platforma-sdk/model/dist/block_api_v1.d.ts
4264
4588
  //#region src/block_api_v1.d.ts
4265
4589
  /** Returned by state subscription methods to be able to cancel the subscription. */
4266
4590
  type CancelSubscription = () => void;
@@ -4320,7 +4644,7 @@ interface BlockApiV1<Args = unknown, Outputs extends BlockOutputsBase = BlockOut
4320
4644
  * Sets block navigation state.
4321
4645
  * */
4322
4646
  setNavigationState(state: NavigationState<Href>): Promise<void>;
4323
- } //#endregion
4647
+ }
4324
4648
  //#endregion
4325
4649
  //#region ../node_modules/.pnpm/fast-json-patch@3.1.1/node_modules/fast-json-patch/module/core.d.ts
4326
4650
  declare type Operation = AddOperation<any> | RemoveOperation | ReplaceOperation<any> | MoveOperation | CopyOperation | TestOperation<any> | GetOperation<any>;
@@ -4355,7 +4679,7 @@ interface GetOperation<T> extends BaseOperation {
4355
4679
  value: T;
4356
4680
  }
4357
4681
  //#endregion
4358
- //#region ../node_modules/.pnpm/@platforma-sdk+model@1.80.2/node_modules/@platforma-sdk/model/dist/block_api_v2.d.ts
4682
+ //#region ../node_modules/.pnpm/@platforma-sdk+model@1.83.0/node_modules/@platforma-sdk/model/dist/block_api_v2.d.ts
4359
4683
  //#region src/block_api_v2.d.ts
4360
4684
  /** Defines methods to read and write current block data. */
4361
4685
  interface BlockApiV2<Args = unknown, Outputs extends BlockOutputsBase = BlockOutputsBase, UiState = unknown, Href extends `/${string}` = `/${string}`> {
@@ -4403,14 +4727,14 @@ interface BlockApiV2<Args = unknown, Outputs extends BlockOutputsBase = BlockOut
4403
4727
  * Disposes the block API.
4404
4728
  * */
4405
4729
  dispose(): Promise<ResultOrError<void>>;
4406
- } //#endregion
4730
+ }
4407
4731
  //#endregion
4408
- //#region ../node_modules/.pnpm/@platforma-sdk+model@1.80.2/node_modules/@platforma-sdk/model/dist/version.d.ts
4732
+ //#region ../node_modules/.pnpm/@platforma-sdk+model@1.83.0/node_modules/@platforma-sdk/model/dist/version.d.ts
4409
4733
  type SdkInfo = {
4410
4734
  readonly sdkVersion: string;
4411
4735
  };
4412
4736
  //#endregion
4413
- //#region ../node_modules/.pnpm/@platforma-sdk+model@1.80.2/node_modules/@platforma-sdk/model/dist/services/block_services.d.ts
4737
+ //#region ../node_modules/.pnpm/@platforma-sdk+model@1.83.0/node_modules/@platforma-sdk/model/dist/services/block_services.d.ts
4414
4738
  //#region src/services/block_services.d.ts
4415
4739
  /**
4416
4740
  * Services required by all V3 blocks by default.
@@ -4427,14 +4751,14 @@ declare const BLOCK_SERVICE_FLAGS: {
4427
4751
  };
4428
4752
  type BlockServiceFlags = typeof BLOCK_SERVICE_FLAGS;
4429
4753
  //#endregion
4430
- //#region ../node_modules/.pnpm/@platforma-sdk+model@1.80.2/node_modules/@platforma-sdk/model/dist/services/service_resolve.d.ts
4754
+ //#region ../node_modules/.pnpm/@platforma-sdk+model@1.83.0/node_modules/@platforma-sdk/model/dist/services/service_resolve.d.ts
4431
4755
  //#region src/services/service_resolve.d.ts
4432
4756
  type FlagToName<Flag extends string> = Flag extends `requires${infer K}` ? K extends keyof ServiceNameLiterals ? ServiceNameLiterals[K] : never : never;
4433
- type RequiredServiceNames<Flags> = { [K in keyof Flags & `requires${string}`]: Flags[K] extends true ? FlagToName<K & string> : never }[keyof Flags & `requires${string}`];
4757
+ type RequiredServiceNames<Flags> = { [K in keyof Flags & `requires${string}`]: Flags[K] extends true ? FlagToName<K & string> : never; }[keyof Flags & `requires${string}`];
4434
4758
  type ResolveUiServices<Flags> = Pick<UiServices$1, RequiredServiceNames<Flags> & keyof UiServices$1>;
4435
- type BlockDefaultUiServices = ResolveUiServices<BlockServiceFlags>; //#endregion
4759
+ type BlockDefaultUiServices = ResolveUiServices<BlockServiceFlags>;
4436
4760
  //#endregion
4437
- //#region ../node_modules/.pnpm/@platforma-sdk+model@1.80.2/node_modules/@platforma-sdk/model/dist/plugin_model.d.ts
4761
+ //#region ../node_modules/.pnpm/@platforma-sdk+model@1.83.0/node_modules/@platforma-sdk/model/dist/plugin_model.d.ts
4438
4762
  /**
4439
4763
  * Runtime definition for a single public output field.
4440
4764
  * Stored in PluginModel and passed through BlockModelInfo to the UI layer.
@@ -4443,7 +4767,7 @@ type PublicOutputFieldDef = {
4443
4767
  readonly getter: (data: unknown) => unknown;
4444
4768
  };
4445
4769
  //#endregion
4446
- //#region ../node_modules/.pnpm/@platforma-sdk+model@1.80.2/node_modules/@platforma-sdk/model/dist/block_api_v3.d.ts
4770
+ //#region ../node_modules/.pnpm/@platforma-sdk+model@1.83.0/node_modules/@platforma-sdk/model/dist/block_api_v3.d.ts
4447
4771
  //#region src/block_api_v3.d.ts
4448
4772
  /** Defines methods to read and write current block data. */
4449
4773
  interface BlockApiV3<_Data = unknown, _Args = unknown, Outputs extends BlockOutputsBase = BlockOutputsBase, Href extends `/${string}` = `/${string}`> {
@@ -4472,9 +4796,9 @@ interface BlockApiV3<_Data = unknown, _Args = unknown, Outputs extends BlockOutp
4472
4796
  * Disposes the block API.
4473
4797
  * */
4474
4798
  dispose(): Promise<ResultOrError<void>>;
4475
- } //#endregion
4799
+ }
4476
4800
  //#endregion
4477
- //#region ../node_modules/.pnpm/@platforma-sdk+model@1.80.2/node_modules/@platforma-sdk/model/dist/platforma.d.ts
4801
+ //#region ../node_modules/.pnpm/@platforma-sdk+model@1.83.0/node_modules/@platforma-sdk/model/dist/platforma.d.ts
4478
4802
  //#region src/platforma.d.ts
4479
4803
  /** Defines all methods to interact with the platform environment from within a block UI. @deprecated */
4480
4804
  interface PlatformaV1<Args = unknown, Outputs extends Record<string, OutputWithStatus<unknown>> = Record<string, OutputWithStatus<unknown>>, UiState = unknown, Href extends `/${string}` = `/${string}`> extends BlockApiV1<Args, Outputs, UiState, Href>, DriverKit {
@@ -4515,29 +4839,48 @@ type InferOutputsType<Pl extends Platforma> = Pl extends Platforma<unknown, infe
4515
4839
  type InferDataType<Pl extends Platforma> = Pl extends Platforma<unknown, Record<string, OutputWithStatus<unknown>>, infer Data> ? Data : never;
4516
4840
  type InferHrefType<Pl extends Platforma> = Pl extends Platforma<unknown, BlockOutputsBase, unknown, infer Href> ? Href : never;
4517
4841
  //#endregion
4518
- //#region ../model/dist/types.d.ts
4842
+ //#region ../kind/dist/types.d.ts
4519
4843
  //#region src/types.d.ts
4844
+ /**
4845
+ * The types the block's init-params contract is built from.
4846
+ *
4847
+ * They live in the kind, not in the model, because the kind owns the contract:
4848
+ * `BlockParams` is what a project template serializes, and a second copy of these
4849
+ * shapes in the model would drift the moment one side gains a case the other
4850
+ * misses. The model re-exports them from here, so every existing import path
4851
+ * keeps working.
4852
+ */
4520
4853
  /** Receptor type. Same enum as sequence-properties to keep label conventions aligned. */
4521
4854
  type WorkflowReceptor = "IG" | "TCRAB" | "TCRGD";
4522
4855
  /**
4523
- * ESM-2 fidelity the user picks per card, projected into args. Default is `standard`.
4524
- * `standard` ESM-2 150M; `high` → ESM-2 650M. Only meaningful when the card's
4856
+ * A scope's receptor, or `"unknown"` when the producer declares VDJ data but no
4857
+ * receptor at all.
4858
+ *
4859
+ * `synthetic-repertoire-profiler` is the case: it declares `pl7.app/modality: vdj`
4860
+ * but emits neither `pl7.app/vdj/receptor` nor `pl7.app/vdj/chain` — germline
4861
+ * auto-detection builds a custom reference from the user's own parent sequences, so
4862
+ * there is no library locus to read a receptor from. Guessing `IG` there would
4863
+ * silently exclude the TCR specialists from a TCR dataset, so the unknown is carried
4864
+ * explicitly and `compat.ts` relaxes receptor/chain gating rather than filtering on
4865
+ * a value nobody supplied.
4866
+ *
4867
+ * Widening only — every previously persisted `WorkflowReceptor` stays valid, so
4868
+ * snapshotted scopes in existing projects deserialize unchanged.
4869
+ */
4870
+ type ScopeReceptor = WorkflowReceptor | "unknown";
4871
+ /**
4872
+ * ESM-2 fidelity the user picks, projected into args. Default is `standard`.
4873
+ * `standard` → ESM-2 150M; `high` → ESM-2 650M. Only meaningful when the
4525
4874
  * model is ESM-2; ignored for the single-checkpoint specialists.
4526
4875
  */
4527
4876
  type Fidelity = "high" | "standard";
4528
4877
  /**
4529
- * User-facing embedding-model choice — the value of a card's model dropdown. A
4878
+ * User-facing embedding-model choice — the value of the model dropdown. A
4530
4879
  * logical id; the workflow maps it (plus `Fidelity` for ESM-2) to a concrete
4531
- * checkpoint `ModelTag`. The catalog and scope↔model compatibility live in
4532
- * `compat.ts`.
4880
+ * checkpoint `ModelTag`. The catalog and scope↔model compatibility live in the
4881
+ * model package's `compat.ts`.
4533
4882
  */
4534
4883
  type EmbeddingModelId = "esm2" | "ablang2" | "currab" | "vhhbert" | "h3berta" | "tcr-bert" | "peptideclm2" | "sceptr";
4535
- /**
4536
- * Checkpoint tag emitted on the `pl7.app/embedding/model` domain of every output
4537
- * column (model provenance). ESM-2 splits by fidelity; specialists are 1:1 with
4538
- * their `EmbeddingModelId`.
4539
- */
4540
- type ModelTag = "esm2-650M" | "esm2-150M" | "ablang2" | "currab" | "vhhbert" | "h3berta" | "tcr-bert" | "peptideclm2" | "sceptr";
4541
4884
  /** Embedding scope feature. `Fv` and `scFv` span/merge chains and carry no `chain`. */
4542
4885
  type ScopeFeature = "peptide" | "CDR3" | "VDJRegion" | "Fv" | "scFv";
4543
4886
  /**
@@ -4546,9 +4889,14 @@ type ScopeFeature = "peptide" | "CDR3" | "VDJRegion" | "Fv" | "scFv";
4546
4889
  * for single-chain scopes, two (`[VH, VL]`) for the paired Fv scope. The column
4547
4890
  * ids (and `isHeavy`/`receptor`) are snapshotted into `BlockData` on the user's
4548
4891
  * gesture (the anchored-id storage pattern), so the args lambda stays `data`-only.
4892
+ *
4893
+ * Those ids are anchored — they resolve against the block's own `inputAnchor`.
4894
+ * That is why a template that carries a scope must carry the matching
4895
+ * `inputAnchor` too; the two params travel as a pair or not at all.
4549
4896
  */
4550
4897
  type SelectedScope = {
4551
- /** Stable picker key. The sequence column id for single scopes; `"Fv"` for paired Fv. */id: string;
4898
+ /** Stable picker key. The sequence column id for single scopes; `"Fv"` for paired Fv. */
4899
+ id: string;
4552
4900
  feature: ScopeFeature;
4553
4901
  chain: "A" | "B" | "";
4554
4902
  columns: SUniversalPColumnId[];
@@ -4557,13 +4905,17 @@ type SelectedScope = {
4557
4905
  * True when this is an IG heavy chain (single-cell chain `A`, or bulk
4558
4906
  * `IGHeavy`). Gates the heavy-only specialists (VHHBERT, H3BERTa) and the
4559
4907
  * VHH-vs-mAb default. Snapshotted so the args lambda stays `data`-only.
4908
+ *
4909
+ * Always `false` when `receptor` is `"unknown"` — a producer that supplies no
4910
+ * receptor supplies no chain either, so this carries no information there and
4911
+ * `compat.ts` does not gate on it.
4560
4912
  */
4561
4913
  isHeavy: boolean;
4562
4914
  /** Receptor of the input this scope came from, snapshotted for `data`-only
4563
- * compatibility validation in the args lambda. */
4564
- receptor: WorkflowReceptor;
4915
+ * compatibility validation in the args lambda. `"unknown"` when the producer
4916
+ * declares VDJ data without a receptor — see `ScopeReceptor`. */
4917
+ receptor: ScopeReceptor;
4565
4918
  };
4566
- /** A selectable scope. Alias of `SelectedScope` — the label lives on the base type. */
4567
4919
  /**
4568
4920
  * The single (sequence scope, model) selection the user assembles. `scope` and
4569
4921
  * `model` are each undefined until picked — the UI fills one and bidirectionally
@@ -4573,15 +4925,20 @@ type SelectedScope = {
4573
4925
  */
4574
4926
  type EmbeddingSelection = {
4575
4927
  scope?: SelectedScope;
4576
- model?: EmbeddingModelId; /** ESM-2 fidelity; ignored for other models. */
4928
+ model?: EmbeddingModelId;
4929
+ /** ESM-2 fidelity; ignored for other models. */
4577
4930
  fidelity?: Fidelity;
4578
4931
  };
4932
+ //#endregion
4933
+ //#endregion
4934
+ //#region ../model/dist/types.d.ts
4935
+ //#region src/types.d.ts
4579
4936
  /**
4580
- * Frozen V2 card shape (per-card model selection, before the single-selection
4581
- * redesign). Kept only as the migration source type so `BlockDataV2` stays
4582
- * historically accurate; new code uses `EmbeddingSelection`. `id` was the stable
4583
- * key for V2's `PlElementList`; dropped in V3.
4937
+ * Checkpoint tag emitted on the `pl7.app/embedding/model` domain of every output
4938
+ * column (model provenance). ESM-2 splits by fidelity; specialists are 1:1 with
4939
+ * their `EmbeddingModelId`.
4584
4940
  */
4941
+ type ModelTag = "esm2-650M" | "esm2-150M" | "ablang2" | "currab" | "vhhbert" | "h3berta" | "tcr-bert" | "peptideclm2" | "sceptr";
4585
4942
  /**
4586
4943
  * V3 BlockData. The card list collapses to a single (scope, model) selection: the
4587
4944
  * block embeds ONE combination per run. `embedding` is always present (init `{}`);
@@ -4589,26 +4946,28 @@ type EmbeddingSelection = {
4589
4946
  * contract is unchanged.
4590
4947
  */
4591
4948
  type BlockDataV3 = {
4592
- inputAnchor?: PlRef; /** The single (scope, model, fidelity?) selection the user assembles. */
4949
+ inputAnchor?: PlRef;
4950
+ /** The single (scope, model, fidelity?) selection the user assembles. */
4593
4951
  embedding: EmbeddingSelection;
4594
4952
  /**
4595
4953
  * Init-guard: canonical id of the anchor whose default selection was last seeded.
4596
4954
  * Prevents re-seeding on panel reopen / server patch; triggers a re-seed on
4597
4955
  * input change.
4598
4956
  */
4599
- embeddingInitializedForAnchor?: string; /** Advanced resource overrides (GiB / cores); undefined → workflow sizes automatically from device + input. */
4957
+ embeddingInitializedForAnchor?: string;
4958
+ /** Advanced resource overrides (GiB / cores); undefined → workflow sizes automatically from device + input. */
4600
4959
  mem?: number;
4601
4960
  cpu?: number;
4602
4961
  defaultBlockLabel?: string;
4603
4962
  };
4604
- /** Current BlockData shape. */
4605
4963
  /**
4606
4964
  * One embedding task in the workflow input: a scope plus the model to embed it
4607
4965
  * with (and ESM-2 fidelity, when applicable). Projected from `BlockData.embedding`.
4608
4966
  */
4609
4967
  type EmbeddingTask = {
4610
4968
  scope: SelectedScope;
4611
- model: EmbeddingModelId; /** ESM-2 fidelity; undefined for other models. */
4969
+ model: EmbeddingModelId;
4970
+ /** ESM-2 fidelity; undefined for other models. */
4612
4971
  fidelity?: Fidelity;
4613
4972
  };
4614
4973
  /**
@@ -4618,21 +4977,23 @@ type EmbeddingTask = {
4618
4977
  * `.argsValid()`).
4619
4978
  */
4620
4979
  type BlockArgs = {
4621
- inputAnchor: PlRef; /** Tasks to emit — a 1-element list projected from `data.embedding` (validated complete + compatible). */
4622
- embeddings: EmbeddingTask[]; /** Advanced resource overrides for the embedding step (GiB / cores); undefined workflow sizes automatically. */
4980
+ inputAnchor: PlRef;
4981
+ /** Tasks to emit a 1-element list projected from `data.embedding` (validated complete + compatible). */
4982
+ embeddings: EmbeddingTask[];
4983
+ /** Advanced resource overrides for the embedding step (GiB / cores); undefined → workflow sizes automatically. */
4623
4984
  mem?: number;
4624
4985
  cpu?: number;
4625
- }; //#endregion
4986
+ };
4626
4987
  //#endregion
4627
4988
  //#region ../model/dist/index.d.ts
4628
4989
  //#region src/index.d.ts
4629
- declare const platforma: PlatformaExtended<PlatformaV3<BlockDataV3, BlockArgs, InferOutputsFromLambdas<{
4990
+ export declare const platforma: PlatformaExtended<PlatformaV3<BlockDataV3, BlockArgs, InferOutputsFromLambdas<{
4630
4991
  inputOptions: ConfigRenderLambda<{
4631
4992
  readonly ref: {
4632
4993
  readonly __isRef: true;
4633
4994
  readonly blockId: string;
4634
4995
  readonly name: string;
4635
- readonly requireEnrichments?: true | undefined | undefined;
4996
+ readonly requireEnrichments?: true | undefined;
4636
4997
  };
4637
4998
  readonly label: string;
4638
4999
  }[]>;
@@ -4645,7 +5006,7 @@ declare const platforma: PlatformaExtended<PlatformaV3<BlockDataV3, BlockArgs, I
4645
5006
  columns: SUniversalPColumnId[];
4646
5007
  label: string;
4647
5008
  isHeavy: boolean;
4648
- receptor: WorkflowReceptor;
5009
+ receptor: ScopeReceptor;
4649
5010
  }[];
4650
5011
  defaults: {
4651
5012
  id: string;
@@ -4654,28 +5015,28 @@ declare const platforma: PlatformaExtended<PlatformaV3<BlockDataV3, BlockArgs, I
4654
5015
  columns: SUniversalPColumnId[];
4655
5016
  label: string;
4656
5017
  isHeavy: boolean;
4657
- receptor: WorkflowReceptor;
5018
+ receptor: ScopeReceptor;
4658
5019
  }[];
4659
5020
  forAnchor: string;
4660
- receptor: WorkflowReceptor;
5021
+ receptor: ScopeReceptor;
4661
5022
  paired: boolean;
4662
5023
  } | undefined>;
4663
5024
  } & {
4664
5025
  stats: ConfigRenderLambda<{
4665
5026
  device_used: "cpu" | "cuda" | "mps";
4666
- device_requested?: "cpu" | "gpu" | undefined;
5027
+ device_requested?: "cpu" | "gpu";
4667
5028
  model: ModelTag;
4668
- max_length?: number | undefined;
5029
+ max_length?: number;
4669
5030
  scopes: {
4670
5031
  name: string;
4671
5032
  feature: "peptide" | "CDR3" | "VDJRegion" | "Fv" | "scFv";
4672
5033
  chain: "A" | "B" | "";
4673
5034
  label: string;
4674
5035
  model: ModelTag;
4675
- max_length?: number | undefined;
4676
- n_entities?: number | undefined;
4677
- n_dropped_empty?: number | undefined;
4678
- n_truncated?: number | null | undefined;
5036
+ max_length?: number;
5037
+ n_entities?: number;
5038
+ n_dropped_empty?: number;
5039
+ n_truncated?: number | null;
4679
5040
  }[];
4680
5041
  } | undefined>;
4681
5042
  } & {
@@ -4687,26 +5048,25 @@ declare const platforma: PlatformaExtended<PlatformaV3<BlockDataV3, BlockArgs, I
4687
5048
  }>, "/", {}, BlockDefaultUiServices>>;
4688
5049
  //#endregion
4689
5050
  //#region src/index.d.ts
4690
- type BlockContract = {
5051
+ export type BlockContract = {
4691
5052
  outputs: InferOutputsType<typeof platforma>;
4692
5053
  data: InferDataType<typeof platforma>;
4693
5054
  href: InferHrefType<typeof platforma>;
4694
5055
  };
4695
- type BlockOutputs = BlockContract["outputs"];
4696
- type BlockData = BlockContract["data"];
4697
- declare const BlockPointer: {
5056
+ export type BlockOutputs = BlockContract["outputs"];
5057
+ export type BlockData = BlockContract["data"];
5058
+ export declare const BlockPointer: {
4698
5059
  readonly type: "from-pack-v2";
4699
5060
  readonly packUrl: string;
4700
5061
  readonly rootUrl: string;
4701
5062
  };
4702
- type SequenceEmbeddingsBlockContract = BlockContract;
4703
- type SequenceEmbeddingsBlockOutputs = BlockOutputs;
4704
- type SequenceEmbeddingsBlockData = BlockData;
4705
- declare const SequenceEmbeddingsBlockPointer: {
5063
+ export type SequenceEmbeddingsBlockContract = BlockContract;
5064
+ export type SequenceEmbeddingsBlockOutputs = BlockOutputs;
5065
+ export type SequenceEmbeddingsBlockData = BlockData;
5066
+ export declare const SequenceEmbeddingsBlockPointer: {
4706
5067
  readonly type: "from-pack-v2";
4707
5068
  readonly packUrl: string;
4708
5069
  readonly rootUrl: string;
4709
5070
  };
4710
5071
  //#endregion
4711
- export { BlockContract, BlockData, BlockOutputs, BlockPointer, SequenceEmbeddingsBlockContract, SequenceEmbeddingsBlockData, SequenceEmbeddingsBlockOutputs, SequenceEmbeddingsBlockPointer, platforma };
4712
5072
  //# sourceMappingURL=index.d.ts.map