@platforma-open/milaboratories.sequence-properties.model 1.1.1

package/dist/types.d.ts

@@ -0,0 +1,22 @@
+import { PlDataTableStateV2, PlRef } from "@platforma-sdk/model";
+
+//#region src/types.d.ts
+type BlockData = {
+  inputAnchor?: PlRef;
+  tableState: PlDataTableStateV2;
+  defaultBlockLabel?: string;
+};
+type BlockArgs = {
+  inputAnchor: PlRef;
+};
+type WorkflowMode = "peptide" | "antibody_tcr_universal" | "antibody_tcr_legacy_bulk" | "antibody_tcr_legacy_sc";
+type WorkflowReceptor = "IG" | "TCRAB" | "TCRGD";
+type WorkflowInfo = {
+  mode?: WorkflowMode;
+  receptor?: WorkflowReceptor;
+  coverageTier?: "full_chain" | "cdr3_only" | "partial" | "peptide";
+  messages: string[];
+};
+//#endregion
+export { BlockArgs, BlockData, WorkflowInfo, WorkflowMode, WorkflowReceptor };
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";;;KAEY,SAAA;EACV,WAAA,GAAc,KAAA;EACd,UAAA,EAAY,kBAAA;EAIZ,iBAAA;AAAA;AAAA,KAGU,SAAA;EACV,WAAA,EAAa,KAAA;AAAA;AAAA,KAGH,YAAA;AAAA,KAMA,gBAAA;AAAA,KAEA,YAAA;EACV,IAAA,GAAO,YAAA;EACP,QAAA,GAAW,gBAAA;EACX,YAAA;EACA,QAAA;AAAA"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@platforma-open/milaboratories.sequence-properties.model",
+  "version": "1.1.1",
+  "description": "Block model",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "sources": "./src/index.ts",
+      "import": "./dist/index.js"
+    },
+    "./dist/*": "./dist/*"
+  },
+  "dependencies": {
+    "@milaboratories/helpers": "^1.14.1",
+    "@platforma-sdk/model": "1.69.0"
+  },
+  "devDependencies": {
+    "@milaboratories/ts-builder": "1.3.2",
+    "@milaboratories/ts-configs": "1.2.3",
+    "@platforma-sdk/block-tools": "2.7.16"
+  },
+  "peerDependencies": {
+    "@types/node": "*",
+    "typescript": "*"
+  },
+  "scripts": {
+    "fmt": "ts-builder format",
+    "watch": "ts-builder build --target block-model --watch",
+    "build": "ts-builder build --target block-model && block-tools build-model",
+    "check": "ts-builder check --target block-model"
+  }
+}

package/src/dataModel.ts

@@ -0,0 +1,6 @@
+import { createPlDataTableStateV2, DataModelBuilder } from "@platforma-sdk/model";
+import type { BlockData } from "./types";
+
+export const blockDataModel = new DataModelBuilder().from<BlockData>("Ver_2026_04_28").init(() => ({
+  tableState: createPlDataTableStateV2(),
+}));

package/src/index.ts

@@ -0,0 +1,103 @@
+import type { ColumnSource, InferOutputsType } from "@platforma-sdk/model";
+import {
+  Annotation,
+  ArrayColumnProvider,
+  BlockModelV3,
+  createPlDataTableV3,
+} from "@platforma-sdk/model";
+import { blockDataModel } from "./dataModel";
+import type { BlockArgs, WorkflowInfo } from "./types";
+
+export type { BlockArgs, BlockData, WorkflowInfo, WorkflowMode, WorkflowReceptor } from "./types";
+export { blockDataModel } from "./dataModel";
+
+const inputAnchorSpecs = [
+  // Peptide mode — universal naming
+  {
+    axes: [{ name: "pl7.app/sampleId" }, { name: "pl7.app/variantKey" }],
+    annotations: { "pl7.app/isAnchor": "true" },
+  },
+  // Antibody/TCR — legacy MiXCR bulk (cloneId per spec; clonotypeKey per current MiXCR output)
+  {
+    axes: [{ name: "pl7.app/sampleId" }, { name: "pl7.app/vdj/cloneId" }],
+    annotations: { "pl7.app/isAnchor": "true" },
+  },
+  {
+    axes: [{ name: "pl7.app/sampleId" }, { name: "pl7.app/vdj/clonotypeKey" }],
+    annotations: { "pl7.app/isAnchor": "true" },
+  },
+  // Antibody/TCR — legacy MiXCR single-cell
+  {
+    axes: [{ name: "pl7.app/sampleId" }, { name: "pl7.app/vdj/scClonotypeKey" }],
+    annotations: { "pl7.app/isAnchor": "true" },
+  },
+];
+
+export const platforma = BlockModelV3.create(blockDataModel)
+  .args<BlockArgs>((data) => {
+    if (data.inputAnchor === undefined) {
+      throw new Error("Select an input dataset");
+    }
+    return {
+      inputAnchor: data.inputAnchor,
+    };
+  })
+  .output("inputOptions", (ctx) =>
+    ctx.resultPool.getOptions(inputAnchorSpecs, { refsWithEnrichments: true }),
+  )
+  .output("inputSpec", (ctx) =>
+    ctx.data.inputAnchor ? ctx.resultPool.getPColumnSpecByRef(ctx.data.inputAnchor) : undefined,
+  )
+  .output("info", (ctx) => ctx.outputs?.resolve("info")?.getDataAsJson<WorkflowInfo>())
+  .output("isRunning", (ctx) => ctx.outputs?.getIsReadyOrError() === false)
+  .output("processingLog", (ctx) => ctx.outputs?.resolve("processingLog")?.getLogHandle())
+  .outputWithStatus("propertiesTable", (ctx) => {
+    if (ctx.data.inputAnchor === undefined) return undefined;
+    const ownCols = ctx.outputs?.resolve("propertiesPf")?.getPColumns();
+    if (ownCols === undefined) return undefined;
+
+    // Build sources explicitly: upstream cols from the result pool minus
+    // anything traced back to this block, plus this block's own cols from
+    // `propertiesPf`. The workflow also publishes `exports.properties` —
+    // a blockId-stamped score-only variant for downstream consumers like
+    // Lead Selection — into the result pool. Filtering by trace excludes
+    // it here so score cols don't duplicate the propertiesPf variant.
+    const upstreamCols = ctx.resultPool.selectColumns(
+      (spec) =>
+        !spec.annotations?.[Annotation.Trace]?.includes("milaboratories.sequence-properties"),
+    );
+    const sources: ColumnSource[] = [
+      new ArrayColumnProvider(upstreamCols),
+      new ArrayColumnProvider(ownCols),
+    ];
+
+    return createPlDataTableV3(ctx, {
+      tableState: ctx.data.tableState,
+      columns: {
+        sources,
+        anchors: { main: ctx.data.inputAnchor },
+        selector: { mode: "enrichment" },
+      },
+      // UX policy (not in spec): default-show only this block's columns;
+      // demote upstream cols to optional to keep the table uncluttered.
+      // This block's cols fall through unmatched and keep the visibility
+      // stamped at workflow-time (`pl7.app/table/visibility`).
+      displayOptions: {
+        visibility: [
+          {
+            match: (spec) =>
+              !spec.annotations?.[Annotation.Trace]?.includes(
+                "milaboratories.sequence-properties",
+              ) && spec.annotations?.["pl7.app/isLinkerColumn"] !== "true",
+            visibility: "optional",
+          },
+        ],
+      },
+    });
+  })
+  .title(() => "Sequence Properties")
+  .subtitle((ctx) => ctx.data.defaultBlockLabel ?? "")
+  .sections(() => [{ type: "link" as const, href: "/" as const, label: "Main" }])
+  .done();
+
+export type BlockOutputs = InferOutputsType<typeof platforma>;

package/src/types.ts

@@ -0,0 +1,29 @@
+import type { PlDataTableStateV2, PlRef } from "@platforma-sdk/model";
+
+export type BlockData = {
+  inputAnchor?: PlRef;
+  tableState: PlDataTableStateV2;
+  // UI-only state. Tracks the selected input dataset's label so the block
+  // subtitle can reflect it — populated by the UI watcher in app.ts. Not
+  // projected into BlockArgs because the workflow does not consume it.
+  defaultBlockLabel?: string;
+};
+
+export type BlockArgs = {
+  inputAnchor: PlRef;
+};
+
+export type WorkflowMode =
+  | "peptide"
+  | "antibody_tcr_universal"
+  | "antibody_tcr_legacy_bulk"
+  | "antibody_tcr_legacy_sc";
+
+export type WorkflowReceptor = "IG" | "TCRAB" | "TCRGD";
+
+export type WorkflowInfo = {
+  mode?: WorkflowMode;
+  receptor?: WorkflowReceptor;
+  coverageTier?: "full_chain" | "cdr3_only" | "partial" | "peptide";
+  messages: string[];
+};

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "@milaboratories/ts-configs/tsconfig.node.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules"]
+}