@platforma-sdk/model 1.22.97 → 1.23.4

package/dist/render/api.d.ts

@@ -1,4 +1,4 @@
-import { AxisId, Option, PColumn, PColumnSpec, PColumnValues, PFrameDef, PFrameHandle, PObject, PObjectSpec, PSpecPredicate, PTableDef, PTableHandle, PTableRecordFilter, PTableSorting, PlRef, ResultCollection, ValueOrError } from '@milaboratories/pl-model-common';
+import { APColumnSelector, AxisId, Option, PColumn, PColumnSelector, PColumnSpec, PColumnValues, PFrameDef, PFrameHandle, PObject, PObjectSpec, PSpecPredicate, PTableDef, PTableHandle, PTableRecordFilter, PTableSorting, PlRef, ResultCollection, ValueOrError, AnchorIdDeriver } from '@milaboratories/pl-model-common';
 import { Optional } from 'utility-types';
 import { TreeNodeAccessor } from './accessor';
 import { FutureRef } from './future';
@@ -10,7 +10,44 @@ export declare class ResultPool {
      */
     calculateOptions(predicate: PSpecPredicate): Option[];
     private defaultLabelFn;
-    getOptions(predicate: (spec: PObjectSpec) => boolean, label?: ((spec: PObjectSpec, ref: PlRef) => string) | LabelDerivationOps): Option[];
+    getOptions(predicateOrSelector: ((spec: PObjectSpec) => boolean) | PColumnSelector | PColumnSelector[], label?: ((spec: PObjectSpec, ref: PlRef) => string) | LabelDerivationOps): Option[];
+    /**
+     * Calculates anchored identifier options for columns matching a given predicate.
+     *
+     * This function filters column specifications from the result pool that match the provided predicate,
+     * creates a standardized AnchorCtx from the provided anchors, and generates a list of label-value
+     * pairs for UI components (like dropdowns).
+     *
+     * @param anchorsOrCtx - Either:
+     *                     - An existing AnchorCtx instance
+     *                     - A record mapping anchor IDs to PColumnSpec objects
+     *                     - A record mapping anchor IDs to PlRef objects (which will be resolved to PColumnSpec)
+     * @param predicateOrSelector - Either:
+     *                            - A predicate function that takes a PColumnSpec and returns a boolean.
+     *                              Only specs that return true will be included.
+     *                            - An APColumnSelector object for declarative filtering, which will be
+     *                              resolved against the provided anchors and matched using matchPColumn.
+     *                            - An array of APColumnSelector objects - columns matching ANY selector
+     *                              in the array will be included (OR operation).
+     * @param labelOps - Optional configuration for label generation:
+     *                 - includeNativeLabel: Whether to include native column labels
+     *                 - separator: String to use between label parts (defaults to " / ")
+     *                 - addLabelAsSuffix: Whether to add labels as suffix instead of prefix
+     * @returns An array of objects with `label` (display text) and `value` (anchored ID string) properties,
+     *          or undefined if any PlRef resolution fails.
+     */
+    getAnchoredOptions(anchorsOrCtx: AnchorIdDeriver, predicateOrSelectors: ((spec: PColumnSpec) => boolean) | APColumnSelector | APColumnSelector[], labelOps?: LabelDerivationOps): {
+        label: string;
+        value: string;
+    }[];
+    getAnchoredOptions(anchorsOrCtx: Record<string, PColumnSpec>, predicateOrSelectors: ((spec: PColumnSpec) => boolean) | APColumnSelector | APColumnSelector[], labelOps?: LabelDerivationOps): {
+        label: string;
+        value: string;
+    }[];
+    getAnchoredOptions(anchorsOrCtx: Record<string, PColumnSpec | PlRef>, predicateOrSelectors: ((spec: PColumnSpec) => boolean) | APColumnSelector | APColumnSelector[], labelOps?: LabelDerivationOps): {
+        label: string;
+        value: string;
+    }[] | undefined;
     /**
      * @deprecated use getData()
      */

package/dist/render/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/render/api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/render/api.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const PlatformaSDKVersion = "1.22.97";
+export declare const PlatformaSDKVersion = "1.23.4";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,YAAY,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,WAAW,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platforma-sdk/model",
-  "version": "1.22.97",
+  "version": "1.23.4",
   "description": "Platforma.bio SDK / Block Model",
   "types": "./dist/index.d.ts",
   "main": "./dist/index.js",
@@ -20,7 +20,7 @@
   "dependencies": {
     "utility-types": "^3.11.0",
     "zod": "~3.23.8",
-    "@milaboratories/pl-model-common": "^1.10.6"
+    "@milaboratories/pl-model-common": "^1.11.0"
   },
   "devDependencies": {
     "typescript": "~5.5.4",
@@ -29,7 +29,8 @@
     "jest": "^29.7.0",
     "@jest/globals": "^29.7.0",
     "ts-jest": "^29.2.6",
-    "@milaboratories/platforma-build-configs": "1.0.2"
+    "@milaboratories/platforma-build-configs": "1.0.2",
+    "@platforma-sdk/eslint-config": "1.0.1"
   },
   "scripts": {
     "type-check": "node ./scripts/save-package-version.cjs && tsc --noEmit --composite false",

package/src/components/PFrameForGraphs.test.ts

@@ -1,5 +1,10 @@
 import {test, expect, describe} from '@jest/globals';
-import {enrichColumnsWithCompatible, getAdditionalColumns, IS_VIRTUAL_COLUMN} from './PFrameForGraphs';
+import {
+    enrichColumnsWithCompatible,
+    getAdditionalColumns,
+    IS_VIRTUAL_COLUMN,
+    LABEL_ANNOTATION
+} from './PFrameForGraphs';
 import {PColumn, PColumnSpec, PColumnValues, PObjectId} from "@milaboratories/pl-model-common";
 import {TreeNodeAccessor} from "../render";
 
@@ -181,4 +186,31 @@ describe('PFrameForGraph', () => {
         const enrichedColumns = enrichColumnsWithCompatible(columns, upstream);
         expect(enrichedColumns.map((c) => c.id)).toEqual(['id1', 'id2', 'id3'])
     })
+
+    test('Labels of added columns include added domains, but not include common domains', () => {
+        const columnSpec1: PColumnSpec = {
+            kind: 'PColumn',
+            name: 'column1',
+            valueType: 'Int',
+            axesSpec: [
+                {type: 'String', name: 'axis1', domain: {key0: 'commonDomain', key1: 'a', key2: 'c'}},
+                {type: 'String', name: 'axis1', domain: {key0: 'commonDomain', key1: 'b', key2: 'c'}},
+            ]
+        }
+        const columnSpec2: PColumnSpec = {
+            kind: 'PColumn',
+            name: 'column2',
+            valueType: 'Int',
+            annotations: {[LABEL_ANNOTATION]: 'Label of column2'},
+            axesSpec: [{type: 'String', name: 'axis1', domain: {key0: 'commonDomain'}}]
+        }
+        const columns: PColumn<TreeNodeAccessor | PColumnValues>[] = [
+            {id: 'id1' as PObjectId, spec: columnSpec1, data: []},
+            {id: 'id2' as PObjectId, spec: columnSpec2, data: []}
+        ] as PColumn<PColumnValues>[]
+
+        const additionalColumns = getAdditionalColumns(columns);
+        expect(additionalColumns[0].spec.annotations?.[LABEL_ANNOTATION]).toEqual('Label of column2 / a');
+        expect(additionalColumns[1].spec.annotations?.[LABEL_ANNOTATION]).toEqual('Label of column2 / b');
+    })
 })

package/src/components/PFrameForGraphs.ts

@@ -62,6 +62,7 @@ function checkCompatibility(
 }
 
 export const IS_VIRTUAL_COLUMN = 'pl7.app/graph/isVirtual'; // annotation for column duplicates with extended domains
+export const LABEL_ANNOTATION = 'pl7.app/label';
 
 /** Main column can have additional domains, if secondary column (meta-column) has all axes match main column axes
  we can add its copy with missed domain fields for compatibility */
@@ -87,8 +88,52 @@ function getAdditionalColumnsForPair(
     // all possible combinations of axes with added domains
     const secondaryIdsVariants = getKeysCombinations(secondaryIdsOptions);
 
-    return secondaryIdsVariants.map(idsList => {
+    // sets of added to column domain fields
+    const allAddedDomainValues = new Set<string>();
+    const addedNotToAllVariantsDomainValues = new Set<string>();
+    const addedByVariantsDomainValues = secondaryIdsVariants.map(idsList => {
+        const addedSet = new Set<string>();
+        idsList.map((axisId, idx) => {
+            const d1 = secondaryColumn.spec.axesSpec[idx].domain;
+            const d2 = axisId.domain;
+            Object.entries(d2 ?? {}).forEach(([key, value]) => {
+                if (d1?.[key] === undefined) {
+                    const item = JSON.stringify([key, value]);
+                    addedSet.add(item);
+                    allAddedDomainValues.add(item);
+                }
+            });
+            return ({
+                ...axisId,
+                annotations: secondaryColumn.spec.axesSpec[idx].annotations
+            })
+        });
+        return addedSet;
+    });
+    [...allAddedDomainValues].forEach(addedPart => {
+        if (addedByVariantsDomainValues.some(s => !s.has(addedPart))) {
+            addedNotToAllVariantsDomainValues.add(addedPart);
+        }
+    })
+
+    return secondaryIdsVariants.map((idsList, idx) => {
         const id = colId(secondaryColumn.id, idsList.map(id => id.domain));
+
+        const label = secondaryColumn.spec.annotations?.[LABEL_ANNOTATION] ?? '';
+        const labelDomainPart = ([...addedByVariantsDomainValues[idx]])
+            .filter(str => addedNotToAllVariantsDomainValues.has(str))
+            .sort()
+            .map((v) => JSON.parse(v)?.[1]) // use in labels only domain values, but sort them by key to save the same order in all column variants
+            .join(' / ');
+
+        const annotations:Record<string, string> = {
+            ...secondaryColumn.spec.annotations,
+            [IS_VIRTUAL_COLUMN]: 'true'
+        }
+        if (label || labelDomainPart) {
+            annotations[LABEL_ANNOTATION] = label && labelDomainPart ? label + ' / ' + labelDomainPart : label + labelDomainPart;
+        }
+
         return {
             id: id as PObjectId,
             spec: {
@@ -97,10 +142,7 @@ function getAdditionalColumnsForPair(
                     ...axisId,
                     annotations: secondaryColumn.spec.axesSpec[idx].annotations
                 })),
-                annotations: {
-                    ...secondaryColumn.spec.annotations,
-                    [IS_VIRTUAL_COLUMN]: 'true'
-                }
+                annotations
             },
             data: secondaryColumn.data
         };

package/src/render/api.ts

@@ -1,7 +1,9 @@
-import {
+import type {
+  APColumnSelector,
   AxisId,
   Option,
   PColumn,
+  PColumnSelector,
   PColumnSpec,
   PColumnValues,
   PFrameDef,
@@ -15,21 +17,29 @@ import {
   PTableSorting,
   PlRef,
   ResultCollection,
-  ValueOrError,
+  ValueOrError } from '@milaboratories/pl-model-common';
+import {
+  AnchorIdDeriver,
+  resolveAnchors } from '@milaboratories/pl-model-common';
+import {
   ensurePColumn,
   extractAllColumns,
   isPColumn,
   isPColumnSpec,
+  isPlRef,
   mapPObjectData,
   mapPTableDef,
-  mapValueInVOE
+  mapValueInVOE,
+  selectorsToPredicate,
 } from '@milaboratories/pl-model-common';
-import { Optional } from 'utility-types';
+import type { Optional } from 'utility-types';
 import { getCfgRenderCtx } from '../internal';
 import { TreeNodeAccessor, ifDef } from './accessor';
-import { FutureRef } from './future';
-import { GlobalCfgRenderCtx, MainAccessorName, StagingAccessorName } from './internal';
-import { LabelDerivationOps, deriveLabels } from './util/label';
+import type { FutureRef } from './future';
+import type { GlobalCfgRenderCtx } from './internal';
+import { MainAccessorName, StagingAccessorName } from './internal';
+import type { LabelDerivationOps } from './util/label';
+import { deriveLabels } from './util/label';
 
 export class ResultPool {
   private readonly ctx: GlobalCfgRenderCtx = getCfgRenderCtx();
@@ -45,22 +55,116 @@ export class ResultPool {
     spec.annotations?.['pl7.app/label'] ?? `Unlabelled`;
 
   public getOptions(
-    predicate: (spec: PObjectSpec) => boolean,
-    label?: ((spec: PObjectSpec, ref: PlRef) => string) | LabelDerivationOps
+    predicateOrSelector: ((spec: PObjectSpec) => boolean) | PColumnSelector | PColumnSelector[],
+    label?: ((spec: PObjectSpec, ref: PlRef) => string) | LabelDerivationOps,
   ): Option[] {
+    const predicate = typeof predicateOrSelector === 'function'
+      ? predicateOrSelector
+      : selectorsToPredicate(predicateOrSelector);
     const filtered = this.getSpecs().entries.filter((s) => predicate(s.obj));
     if (typeof label === 'object' || typeof label === 'undefined') {
       return deriveLabels(filtered, (o) => o.obj, label ?? {}).map(({ value: { ref }, label }) => ({
         ref,
-        label
+        label,
       }));
     } else
       return filtered.map((s) => ({
         ref: s.ref,
-        label: label(s.obj, s.ref)
+        label: label(s.obj, s.ref),
       }));
   }
 
+  /**
+   * Calculates anchored identifier options for columns matching a given predicate.
+   *
+   * This function filters column specifications from the result pool that match the provided predicate,
+   * creates a standardized AnchorCtx from the provided anchors, and generates a list of label-value
+   * pairs for UI components (like dropdowns).
+   *
+   * @param anchorsOrCtx - Either:
+   *                     - An existing AnchorCtx instance
+   *                     - A record mapping anchor IDs to PColumnSpec objects
+   *                     - A record mapping anchor IDs to PlRef objects (which will be resolved to PColumnSpec)
+   * @param predicateOrSelector - Either:
+   *                            - A predicate function that takes a PColumnSpec and returns a boolean.
+   *                              Only specs that return true will be included.
+   *                            - An APColumnSelector object for declarative filtering, which will be
+   *                              resolved against the provided anchors and matched using matchPColumn.
+   *                            - An array of APColumnSelector objects - columns matching ANY selector
+   *                              in the array will be included (OR operation).
+   * @param labelOps - Optional configuration for label generation:
+   *                 - includeNativeLabel: Whether to include native column labels
+   *                 - separator: String to use between label parts (defaults to " / ")
+   *                 - addLabelAsSuffix: Whether to add labels as suffix instead of prefix
+   * @returns An array of objects with `label` (display text) and `value` (anchored ID string) properties,
+   *          or undefined if any PlRef resolution fails.
+   */
+  // Overload for AnchorCtx - guaranteed to never return undefined
+  getAnchoredOptions(
+    anchorsOrCtx: AnchorIdDeriver,
+    predicateOrSelectors: ((spec: PColumnSpec) => boolean) | APColumnSelector | APColumnSelector[],
+    labelOps?: LabelDerivationOps,
+  ): { label: string; value: string }[];
+
+  // Overload for Record<string, PColumnSpec> - guaranteed to never return undefined
+  getAnchoredOptions(
+    anchorsOrCtx: Record<string, PColumnSpec>,
+    predicateOrSelectors: ((spec: PColumnSpec) => boolean) | APColumnSelector | APColumnSelector[],
+    labelOps?: LabelDerivationOps,
+  ): { label: string; value: string }[];
+
+  // Overload for Record<string, PColumnSpec | PlRef> - may return undefined if PlRef resolution fails
+  getAnchoredOptions(
+    anchorsOrCtx: Record<string, PColumnSpec | PlRef>,
+    predicateOrSelectors: ((spec: PColumnSpec) => boolean) | APColumnSelector | APColumnSelector[],
+    labelOps?: LabelDerivationOps,
+  ): { label: string; value: string }[] | undefined;
+
+  // Implementation
+  getAnchoredOptions(
+    anchorsOrCtx: AnchorIdDeriver | Record<string, PColumnSpec | PlRef>,
+    predicateOrSelectors: ((spec: PColumnSpec) => boolean) | APColumnSelector | APColumnSelector[],
+    labelOps?: LabelDerivationOps,
+  ): { label: string; value: string }[] | undefined {
+  // Handle PlRef objects by resolving them to PColumnSpec
+    const resolvedAnchors: Record<string, PColumnSpec> = {};
+
+    if (!(anchorsOrCtx instanceof AnchorIdDeriver)) {
+      for (const [key, value] of Object.entries(anchorsOrCtx)) {
+        if (isPlRef(value)) {
+          const resolvedSpec = this.getPColumnSpecByRef(value);
+          if (!resolvedSpec)
+            return undefined;
+          resolvedAnchors[key] = resolvedSpec;
+        } else {
+          // It's already a PColumnSpec
+          resolvedAnchors[key] = value as PColumnSpec;
+        }
+      }
+    }
+
+    const predicate = typeof predicateOrSelectors === 'function'
+      ? predicateOrSelectors
+      : selectorsToPredicate(Array.isArray(predicateOrSelectors)
+        ? predicateOrSelectors.map((selector) => resolveAnchors(resolvedAnchors, selector))
+        : resolveAnchors(resolvedAnchors, predicateOrSelectors),
+      );
+
+    const filtered = this.getSpecs().entries.filter(({ obj: spec }) => {
+      if (!isPColumnSpec(spec)) return false;
+      return predicate(spec);
+    });
+
+    const anchorIdDeriver = anchorsOrCtx instanceof AnchorIdDeriver
+      ? anchorsOrCtx
+      : new AnchorIdDeriver(resolvedAnchors);
+
+    return deriveLabels(filtered, (o) => o.obj, labelOps ?? {}).map(({ value: { obj: spec }, label }) => ({
+      value: anchorIdDeriver.deriveString(spec as PColumnSpec)!,
+      label,
+    }));
+  }
+
   /**
    * @deprecated use getData()
    */
@@ -76,9 +180,9 @@ export class ResultPool {
         ref: e.ref,
         obj: {
           ...e.obj,
-          data: new TreeNodeAccessor(e.obj.data, [e.ref.blockId, e.ref.name])
-        }
-      }))
+          data: new TreeNodeAccessor(e.obj.data, [e.ref.blockId, e.ref.name]),
+        },
+      })),
     };
   }
 
@@ -103,10 +207,10 @@ export class ResultPool {
           ...e.obj,
           data: mapValueInVOE(
             e.obj.data,
-            (handle) => new TreeNodeAccessor(handle, [e.ref.blockId, e.ref.name])
-          )
-        }
-      }))
+            (handle) => new TreeNodeAccessor(handle, [e.ref.blockId, e.ref.name]),
+          ),
+        },
+      })),
     };
   }
 
@@ -129,11 +233,11 @@ export class ResultPool {
     // @TODO remove after 1 Jan 2025; forward compatibility
     if (typeof this.ctx.getDataFromResultPoolByRef === 'undefined')
       return this.getData().entries.find(
-        (f) => f.ref.blockId === ref.blockId && f.ref.name === ref.name
+        (f) => f.ref.blockId === ref.blockId && f.ref.name === ref.name,
       )?.obj;
     return mapPObjectData(
       this.ctx.getDataFromResultPoolByRef(ref.blockId, ref.name),
-      (handle) => new TreeNodeAccessor(handle, [ref.blockId, ref.name])
+      (handle) => new TreeNodeAccessor(handle, [ref.blockId, ref.name]),
     );
   }
 
@@ -165,11 +269,6 @@ export class ResultPool {
    * @returns object spec associated with the ref
    */
   public getSpecByRef(ref: PlRef): PObjectSpec | undefined {
-    // @TODO remove after 1 Jan 2025; forward compatibility
-    if (typeof this.ctx.getSpecFromResultPoolByRef === 'undefined')
-      return this.getSpecs().entries.find(
-        (f) => f.ref.blockId === ref.blockId && f.ref.name === ref.name
-      )?.obj;
     return this.ctx.getSpecFromResultPoolByRef(ref.blockId, ref.name);
   }
 
@@ -256,7 +355,7 @@ export class RenderCtx<Args, UiState> {
   public get activeArgs(): Args | undefined {
     if (this._activeArgsCache === undefined)
       this._activeArgsCache = {
-        v: this.ctx.activeArgs ? JSON.parse(this.ctx.activeArgs) : undefined
+        v: this.ctx.activeArgs ? JSON.parse(this.ctx.activeArgs) : undefined,
       };
     return this._activeArgsCache.v;
   }
@@ -269,7 +368,7 @@ export class RenderCtx<Args, UiState> {
   private getNamedAccessor(name: string): TreeNodeAccessor | undefined {
     return ifDef(
       this.ctx.getAccessorHandleByName(name),
-      (accessor) => new TreeNodeAccessor(accessor, [name])
+      (accessor) => new TreeNodeAccessor(accessor, [name]),
     );
   }
 
@@ -294,11 +393,11 @@ export class RenderCtx<Args, UiState> {
 
       const spec = column.obj.spec;
       if (
-        spec.name === 'pl7.app/label' &&
-        spec.axesSpec.length === 1 &&
-        spec.axesSpec[0].name === axis.name &&
-        spec.axesSpec[0].type === axis.type &&
-        matchDomain(axis.domain, spec.axesSpec[0].domain)
+        spec.name === 'pl7.app/label'
+        && spec.axesSpec.length === 1
+        && spec.axesSpec[0].name === axis.name
+        && spec.axesSpec[0].type === axis.type
+        && matchDomain(axis.domain, spec.axesSpec[0].domain)
       ) {
         if (column.obj.data.resourceType.name !== 'PColumnData/Json') {
           throw Error(`Expected JSON column for labels, got: ${column.obj.data.resourceType.name}`);
@@ -307,8 +406,8 @@ export class RenderCtx<Args, UiState> {
           Object.entries(
             column.obj.data.getDataAsJson<{
               data: Record<string | number, string>;
-            }>().data
-          ).map((e) => [JSON.parse(e[0])[0], e[1]])
+            }>().data,
+          ).map((e) => [JSON.parse(e[0])[0], e[1]]),
         );
 
         return labels;
@@ -326,7 +425,7 @@ export class RenderCtx<Args, UiState> {
   public createPFrame(def: PFrameDef<TreeNodeAccessor | PColumnValues>): PFrameHandle {
     this.verifyInlineColumnsSupport(def);
     return this.ctx.createPFrame(
-      def.map((c) => mapPObjectData(c, (d) => (d instanceof TreeNodeAccessor ? d.handle : d)))
+      def.map((c) => mapPObjectData(c, (d) => (d instanceof TreeNodeAccessor ? d.handle : d))),
     );
   }
 
@@ -341,21 +440,21 @@ export class RenderCtx<Args, UiState> {
     def:
       | PTableDef<PColumn<TreeNodeAccessor | PColumnValues>>
       | {
-          columns: PColumn<TreeNodeAccessor | PColumnValues>[];
-          filters?: PTableRecordFilter[];
-          /** Table sorting */
-          sorting?: PTableSorting[];
-        }
+        columns: PColumn<TreeNodeAccessor | PColumnValues>[];
+        filters?: PTableRecordFilter[];
+        /** Table sorting */
+        sorting?: PTableSorting[];
+      },
   ): PTableHandle {
-    var rawDef: PTableDef<PColumn<TreeNodeAccessor | PColumnValues>>;
+    let rawDef: PTableDef<PColumn<TreeNodeAccessor | PColumnValues>>;
     if ('columns' in def) {
       rawDef = {
         src: {
           type: 'full',
-          entries: def.columns.map((c) => ({ type: 'column', column: c }))
+          entries: def.columns.map((c) => ({ type: 'column', column: c })),
         },
         filters: def.filters ?? [],
-        sorting: def.sorting ?? []
+        sorting: def.sorting ?? [],
       };
     } else {
       rawDef = def;
@@ -363,8 +462,8 @@ export class RenderCtx<Args, UiState> {
     this.verifyInlineColumnsSupport(extractAllColumns(rawDef.src));
     return this.ctx.createPTable(
       mapPTableDef(rawDef, (po) =>
-        mapPObjectData(po, (d) => (d instanceof TreeNodeAccessor ? d.handle : d))
-      )
+        mapPObjectData(po, (d) => (d instanceof TreeNodeAccessor ? d.handle : d)),
+      ),
     );
   }