@platforma-open/milaboratories.software-ptabler.schema 1.9.0 → 1.11.0

package/dist/expressions.d.ts

@@ -1,5 +1,5 @@
 import { DataType } from './common';
-export type Expression = ComparisonExpression | BinaryArithmeticExpression | UnaryArithmeticExpression | CastExpression | BooleanLogicExpression | NotExpression | NullCheckExpression | StringJoinExpression | HashExpression | ColumnReferenceExpression | ConstantValueExpression | RankExpression | CumsumExpression | ExtendedUnaryStringExpression | StringDistanceExpression | FuzzyStringFilterExpression | WhenThenOtherwiseExpression | SubstringExpression | StringReplaceExpression | StringContainsExpression | StringStartsWithExpression | StringEndsWithExpression | StringContainsAnyExpression | StringCountMatchesExpression | StringExtractExpression | MinMaxExpression | FillNaExpression | WindowExpression;
+export type Expression = ComparisonExpression | BinaryArithmeticExpression | UnaryArithmeticExpression | CastExpression | BooleanLogicExpression | NotExpression | NullCheckExpression | StringJoinExpression | HashExpression | ColumnReferenceExpression | ConstantValueExpression | RankExpression | CumsumExpression | ExtendedUnaryStringExpression | StringDistanceExpression | FuzzyStringFilterExpression | WhenThenOtherwiseExpression | SubstringExpression | StringReplaceExpression | StringContainsExpression | StringStartsWithExpression | StringEndsWithExpression | StringContainsAnyExpression | StringCountMatchesExpression | StringExtractExpression | MinMaxExpression | FillNaExpression | WindowExpression | StructFieldExpression;
 /** Represents all possible expression types in the system. */
 export type ComparisonOperator = 'gt' | 'ge' | 'eq' | 'lt' | 'le' | 'neq';
 /** Defines a comparison operation between two expressions. */
@@ -406,3 +406,19 @@ export interface WindowExpression {
     /** List of expressions to partition the data by. The aggregation is performed independently within each partition. */
     partitionBy: Expression[];
 }
+/**
+ * Represents a struct field access operation.
+ * This operation retrieves a single field from a struct (nested data structure).
+ * It corresponds to Polars' struct.field() functionality.
+ */
+export interface StructFieldExpression {
+    /** The type of operation, always 'struct_field'. */
+    type: 'struct_field';
+    /** The struct expression to extract fields from. */
+    struct: Expression;
+    /**
+     * The field name to extract from the struct.
+     * Currently only supports single field extraction due to Polars behavior limitations.
+     */
+    fields: string;
+}

package/dist/index.d.ts

@@ -9,3 +9,4 @@ export type PTablerWorkflow = {
     workflow: PTablerStep[];
 };
 export type { BaseFileReadStep, BaseFileWriteStep };
+export type { Expression, StructFieldExpression } from './expressions';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platforma-open/milaboratories.software-ptabler.schema",
-  "version": "1.9.0",
+  "version": "1.11.0",
   "description": "Type definitions for PTabler",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",

package/src/expressions.ts

@@ -28,7 +28,8 @@ export type Expression =
   | StringExtractExpression
   | MinMaxExpression
   | FillNaExpression
-  | WindowExpression;
+  | WindowExpression
+  | StructFieldExpression;
 
 /** Represents all possible expression types in the system. */
 export type ComparisonOperator = 'gt' | 'ge' | 'eq' | 'lt' | 'le' | 'neq';
@@ -514,3 +515,20 @@ export interface WindowExpression {
   /** List of expressions to partition the data by. The aggregation is performed independently within each partition. */
   partitionBy: Expression[];
 }
+
+/**
+ * Represents a struct field access operation.
+ * This operation retrieves a single field from a struct (nested data structure).
+ * It corresponds to Polars' struct.field() functionality.
+ */
+export interface StructFieldExpression {
+  /** The type of operation, always 'struct_field'. */
+  type: 'struct_field';
+  /** The struct expression to extract fields from. */
+  struct: Expression;
+  /**
+   * The field name to extract from the struct.
+   * Currently only supports single field extraction due to Polars behavior limitations.
+   */
+  fields: string;
+}

package/src/index.ts

@@ -1,4 +1,4 @@
-import type { ReadCsvStep, ReadNdjsonStep, WriteCsvStep, WriteJsonStep, WriteNdjsonStep, BaseFileReadStep, BaseFileWriteStep } from './io';
+import type { ReadCsvStep, ReadNdjsonStep, WriteCsvStep, WriteNdjsonStep, BaseFileReadStep, BaseFileWriteStep } from './io';
 import type { AddColumnsStep, FilterStep, SelectStep, WithColumnsStep, WithoutColumnsStep } from './basic_steps';
 import type { AggregateStep } from './aggregate';
 import type { AnyJoinStep } from './join';
@@ -26,3 +26,6 @@ export type PTablerWorkflow = {
 
 // Re-export base interfaces for potential external use
 export type { BaseFileReadStep, BaseFileWriteStep };
+
+// Re-export expression types for external use
+export type { Expression, StructFieldExpression } from './expressions';