@platforma-open/milaboratories.humanization-score.model 0.2.0 → 0.3.1

package/dist/index.cjs

@@ -1,28 +1,39 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let _platforma_sdk_model = require("@platforma-sdk/model");
 //#region src/index.ts
+const HUMANNESS_SCORE_COLUMN = "pl7.app/humannessScore";
+const defaultGraphStateHistogram = () => ({
+	title: "Humanness Score Distribution",
+	template: "bins",
+	currentTab: null,
+	axesSettings: { other: { binsCount: 20 } },
+	layersSettings: { bins: { fillColor: "#2D93FA" } }
+});
+const inputSelectors = [{
+	axes: [{ name: "pl7.app/sampleId" }, { name: "pl7.app/vdj/clonotypeKey" }],
+	annotations: { "pl7.app/isAnchor": "true" }
+}, {
+	axes: [{ name: "pl7.app/sampleId" }, { name: "pl7.app/vdj/scClonotypeKey" }],
+	annotations: { "pl7.app/isAnchor": "true" }
+}];
 const dataModel = new _platforma_sdk_model.DataModelBuilder().from("v1").upgradeLegacy(({ args, uiState }) => ({
 	...args,
-	tableState: uiState.tableState
+	tableState: uiState.tableState,
+	graphStateHistogram: uiState.graphStateHistogram ?? defaultGraphStateHistogram()
 })).init(() => ({
 	customBlockLabel: "",
-	tableState: (0, _platforma_sdk_model.createPlDataTableStateV2)()
+	tableState: (0, _platforma_sdk_model.createPlDataTableStateV2)(),
+	graphStateHistogram: defaultGraphStateHistogram()
 }));
 const platforma = _platforma_sdk_model.BlockModelV3.create(dataModel).args((data) => {
 	if (!data.inputAnchor) throw new Error("Input anchor is required");
 	return {
-		customBlockLabel: data.customBlockLabel || "Humanness Score",
+		customBlockLabel: data.customBlockLabel || "",
 		inputAnchor: data.inputAnchor,
 		mem: data.mem
 	};
-}).output("inputOptions", (ctx) => ctx.resultPool.getOptions([{
-	axes: [{ name: "pl7.app/sampleId" }, { name: "pl7.app/vdj/clonotypeKey" }],
-	annotations: { "pl7.app/isAnchor": "true" }
-}, {
-	axes: [{ name: "pl7.app/sampleId" }, { name: "pl7.app/vdj/scClonotypeKey" }],
-	annotations: { "pl7.app/isAnchor": "true" }
-}])).outputWithStatus("pt", (ctx) => {
-	const pCols = ctx.outputs?.resolve("outputLiabilities")?.getPColumns();
+}).output("inputOptions", (ctx) => ctx.resultPool.getOptions(inputSelectors)).outputWithStatus("pt", (ctx) => {
+	const pCols = ctx.outputs?.resolve("outputHumanness")?.getPColumns();
 	if (pCols === void 0) return;
 	return (0, _platforma_sdk_model.createPlDataTableV3)(ctx, {
 		tableState: ctx.data.tableState,
@@ -31,12 +42,32 @@ const platforma = _platforma_sdk_model.BlockModelV3.create(dataModel).args((data
 			isPrimary: true
 		}))
 	});
-}).output("isRunning", (ctx) => ctx.outputs?.getIsReadyOrError() === false).title(() => "Humanness Score").subtitle((ctx) => ctx.data.customBlockLabel || "Humanness Score").sections((_) => [{
+}).outputWithStatus("histogramPf", (ctx) => {
+	const pCols = ctx.outputs?.resolve("outputHumanness")?.getPColumns();
+	if (pCols === void 0) return void 0;
+	return (0, _platforma_sdk_model.createPFrameForGraphs)(ctx, pCols);
+}).output("histogramPfPcols", (ctx) => {
+	const pCols = ctx.outputs?.resolve("outputHumanness")?.getPColumns();
+	if (pCols === void 0 || pCols.length === 0) return void 0;
+	return pCols.map((c) => ({
+		columnId: c.id,
+		spec: c.spec
+	}));
+}).output("isRunning", (ctx) => ctx.outputs?.getIsReadyOrError() === false).title(() => "Humanization Score").subtitle((ctx) => {
+	if (ctx.data.customBlockLabel) return ctx.data.customBlockLabel;
+	return "Humanization Score";
+}).sections((_) => [{
 	type: "link",
 	href: "/",
 	label: "Table"
+}, {
+	type: "link",
+	href: "/histogram",
+	label: "Score Distribution"
 }]).done();
 //#endregion
+exports.HUMANNESS_SCORE_COLUMN = HUMANNESS_SCORE_COLUMN;
+exports.defaultGraphStateHistogram = defaultGraphStateHistogram;
 exports.platforma = platforma;
 
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["DataModelBuilder","BlockModelV3","ArrayColumnProvider"],"sources":["../src/index.ts"],"sourcesContent":["import type {\n  PlDataTableStateV2,\n  PlRef,\n} from '@platforma-sdk/model';\nimport {\n  ArrayColumnProvider,\n  BlockModelV3,\n  DataModelBuilder,\n  createPlDataTableStateV2,\n  createPlDataTableV3,\n} from '@platforma-sdk/model';\nexport type * from '@milaboratories/helpers';\n\ntype OldArgs = {\n  customBlockLabel: string;\n  inputAnchor?: PlRef;\n  mem?: number;\n};\n\ntype OldUiState = {\n  tableState: PlDataTableStateV2;\n};\n\nexport type BlockData = {\n  customBlockLabel: string;\n  inputAnchor?: PlRef;\n  mem?: number;\n  tableState: PlDataTableStateV2;\n};\n\nconst dataModel = new DataModelBuilder()\n  .from<BlockData>('v1')\n  .upgradeLegacy<OldArgs, OldUiState>(({ args, uiState }) => ({\n    ...args,\n    tableState: uiState.tableState,\n  }))\n  .init(() => ({\n    customBlockLabel: '',\n    tableState: createPlDataTableStateV2(),\n  }));\n\nexport const platforma = BlockModelV3.create(dataModel)\n\n  .args((data) => {\n    if (!data.inputAnchor) throw new Error('Input anchor is required');\n\n    return {\n      customBlockLabel: data.customBlockLabel || 'Humanness Score',\n      inputAnchor: data.inputAnchor,\n      mem: data.mem,\n    };\n  })\n\n  .output('inputOptions', (ctx) =>\n    ctx.resultPool.getOptions([{\n      axes: [\n        { name: 'pl7.app/sampleId' },\n        { name: 'pl7.app/vdj/clonotypeKey' },\n      ],\n      annotations: { 'pl7.app/isAnchor': 'true' },\n    }, {\n      axes: [\n        { name: 'pl7.app/sampleId' },\n        { name: 'pl7.app/vdj/scClonotypeKey' },\n      ],\n      annotations: { 'pl7.app/isAnchor': 'true' },\n    }]),\n  )\n\n  .outputWithStatus('pt', (ctx) => {\n    const pCols = ctx.outputs?.resolve('outputLiabilities')?.getPColumns();\n    if (pCols === undefined) {\n      return undefined;\n    }\n    return createPlDataTableV3(ctx, {\n      tableState: ctx.data.tableState,\n      columns: new ArrayColumnProvider(pCols)\n        .getAllColumns()\n        .map((column) => ({ column, isPrimary: true })),\n    });\n  })\n\n  .output('isRunning', (ctx) => ctx.outputs?.getIsReadyOrError() === false)\n\n  .title(() => 'Humanness Score')\n\n  .subtitle((ctx) => ctx.data.customBlockLabel || 'Humanness Score')\n\n  .sections((_) => [\n    { type: 'link', href: '/', label: 'Table' },\n  ])\n\n  .done();\n"],"mappings":";;;AA8BA,MAAM,YAAY,IAAIA,qBAAAA,kBAAkB,CACrC,KAAgB,KAAK,CACrB,eAAoC,EAAE,MAAM,eAAe;CAC1D,GAAG;CACH,YAAY,QAAQ;CACrB,EAAE,CACF,YAAY;CACX,kBAAkB;CAClB,aAAA,GAAA,qBAAA,2BAAsC;CACvC,EAAE;AAEL,MAAa,YAAYC,qBAAAA,aAAa,OAAO,UAAU,CAEpD,MAAM,SAAS;CACd,IAAI,CAAC,KAAK,aAAa,MAAM,IAAI,MAAM,2BAA2B;CAElE,OAAO;EACL,kBAAkB,KAAK,oBAAoB;EAC3C,aAAa,KAAK;EAClB,KAAK,KAAK;EACX;EACD,CAED,OAAO,iBAAiB,QACvB,IAAI,WAAW,WAAW,CAAC;CACzB,MAAM,CACJ,EAAE,MAAM,oBAAoB,EAC5B,EAAE,MAAM,4BAA4B,CACrC;CACD,aAAa,EAAE,oBAAoB,QAAQ;CAC5C,EAAE;CACD,MAAM,CACJ,EAAE,MAAM,oBAAoB,EAC5B,EAAE,MAAM,8BAA8B,CACvC;CACD,aAAa,EAAE,oBAAoB,QAAQ;CAC5C,CAAC,CAAC,CACJ,CAEA,iBAAiB,OAAO,QAAQ;CAC/B,MAAM,QAAQ,IAAI,SAAS,QAAQ,oBAAoB,EAAE,aAAa;CACtE,IAAI,UAAU,KAAA,GACZ;CAEF,QAAA,GAAA,qBAAA,qBAA2B,KAAK;EAC9B,YAAY,IAAI,KAAK;EACrB,SAAS,IAAIC,qBAAAA,oBAAoB,MAAM,CACpC,eAAe,CACf,KAAK,YAAY;GAAE;GAAQ,WAAW;GAAM,EAAE;EAClD,CAAC;EACF,CAED,OAAO,cAAc,QAAQ,IAAI,SAAS,mBAAmB,KAAK,MAAM,CAExE,YAAY,kBAAkB,CAE9B,UAAU,QAAQ,IAAI,KAAK,oBAAoB,kBAAkB,CAEjE,UAAU,MAAM,CACf;CAAE,MAAM;CAAQ,MAAM;CAAK,OAAO;CAAS,CAC5C,CAAC,CAED,MAAM"}
+{"version":3,"file":"index.cjs","names":["DataModelBuilder","BlockModelV3","ArrayColumnProvider"],"sources":["../src/index.ts"],"sourcesContent":["import type { GraphMakerState } from '@milaboratories/graph-maker';\nimport type {\n  PColumnIdAndSpec,\n  PFrameHandle,\n  PlDataTableStateV2,\n  PlRef,\n} from '@platforma-sdk/model';\nimport {\n  ArrayColumnProvider,\n  BlockModelV3,\n  DataModelBuilder,\n  createPFrameForGraphs,\n  createPlDataTableStateV2,\n  createPlDataTableV3,\n} from '@platforma-sdk/model';\nexport type * from '@milaboratories/helpers';\n\ntype OldArgs = {\n  customBlockLabel: string;\n  inputAnchor?: PlRef;\n  mem?: number;\n};\n\ntype OldUiState = {\n  tableState: PlDataTableStateV2;\n  graphStateHistogram?: GraphMakerState;\n};\n\nexport type BlockData = {\n  customBlockLabel: string;\n  inputAnchor?: PlRef;\n  mem?: number;\n  tableState: PlDataTableStateV2;\n  // Distribution of the per-clonotype humanness score across the whole dataset.\n  graphStateHistogram: GraphMakerState;\n};\n\n// Humanness score column name emitted by `clonotype-process.tpl.tengo`.\nexport const HUMANNESS_SCORE_COLUMN = 'pl7.app/humannessScore';\n\nexport const defaultGraphStateHistogram = (): GraphMakerState => ({\n  title: 'Humanness Score Distribution',\n  template: 'bins',\n  currentTab: null,\n  axesSettings: {\n    other: { binsCount: 20 },\n  },\n  // Give the bars a solid fill instead of the default white — colour values\n  // taken from graph-maker's fixed palette (\"Blue\").\n  layersSettings: {\n    bins: { fillColor: '#2D93FA' },\n  },\n});\n\n// Selectors for the input dataset anchor — shared between `inputOptions`\n// (the dropdown) and `subtitle` (so the default label matches the dataset name).\nconst inputSelectors = [{\n  axes: [\n    { name: 'pl7.app/sampleId' },\n    { name: 'pl7.app/vdj/clonotypeKey' },\n  ],\n  annotations: { 'pl7.app/isAnchor': 'true' },\n}, {\n  axes: [\n    { name: 'pl7.app/sampleId' },\n    { name: 'pl7.app/vdj/scClonotypeKey' },\n  ],\n  annotations: { 'pl7.app/isAnchor': 'true' },\n}];\n\nconst dataModel = new DataModelBuilder()\n  .from<BlockData>('v1')\n  .upgradeLegacy<OldArgs, OldUiState>(({ args, uiState }) => ({\n    ...args,\n    tableState: uiState.tableState,\n    graphStateHistogram: uiState.graphStateHistogram ?? defaultGraphStateHistogram(),\n  }))\n  .init(() => ({\n    customBlockLabel: '',\n    tableState: createPlDataTableStateV2(),\n    graphStateHistogram: defaultGraphStateHistogram(),\n  }));\n\nexport const platforma = BlockModelV3.create(dataModel)\n\n  .args((data) => {\n    if (!data.inputAnchor) throw new Error('Input anchor is required');\n\n    return {\n      // Empty when unset; the workflow falls back to the input dataset name so\n      // the provenance trace label matches the block subtitle.\n      customBlockLabel: data.customBlockLabel || '',\n      inputAnchor: data.inputAnchor,\n      mem: data.mem,\n    };\n  })\n\n  .output('inputOptions', (ctx) =>\n    ctx.resultPool.getOptions(inputSelectors),\n  )\n\n  .outputWithStatus('pt', (ctx) => {\n    const pCols = ctx.outputs?.resolve('outputHumanness')?.getPColumns();\n    if (pCols === undefined) {\n      return undefined;\n    }\n    return createPlDataTableV3(ctx, {\n      tableState: ctx.data.tableState,\n      columns: new ArrayColumnProvider(pCols)\n        .getAllColumns()\n        .map((column) => ({ column, isPrimary: true })),\n    });\n  })\n\n  // --- Score distribution (histogram) ---------------------------------------\n  // One row per clonotype, so the histogram counts UNIQUE clonotypes by humanness\n  // score — it is deliberately NOT weighted by clonotype abundance. The question it\n  // answers is \"how many distinct candidates sit below/above a humanness level\"\n  // (i.e. how much humanization work is there), not \"how human is the repertoire by\n  // read mass\". No human-like threshold line is drawn: this score is a 9-mer\n  // fraction rescaled to 0..100, not a cutoff validated against therapeutic mAbs.\n  .outputWithStatus('histogramPf', (ctx): PFrameHandle | undefined => {\n    const pCols = ctx.outputs?.resolve('outputHumanness')?.getPColumns();\n    if (pCols === undefined) return undefined;\n    return createPFrameForGraphs(ctx, pCols);\n  })\n\n  .output('histogramPfPcols', (ctx): PColumnIdAndSpec[] | undefined => {\n    const pCols = ctx.outputs?.resolve('outputHumanness')?.getPColumns();\n    if (pCols === undefined || pCols.length === 0) return undefined;\n    return pCols.map((c) => ({ columnId: c.id, spec: c.spec }));\n  })\n\n  .output('isRunning', (ctx) => ctx.outputs?.getIsReadyOrError() === false)\n\n  .title(() => 'Humanization Score')\n\n  .subtitle((ctx) => {\n    if (ctx.data.customBlockLabel) return ctx.data.customBlockLabel;\n    return 'Humanization Score';\n  })\n\n  .sections((_) => [\n    { type: 'link', href: '/', label: 'Table' },\n    { type: 'link', href: '/histogram', label: 'Score Distribution' },\n  ])\n\n  .done();\n"],"mappings":";;;AAsCA,MAAa,yBAAyB;AAEtC,MAAa,oCAAqD;CAChE,OAAO;CACP,UAAU;CACV,YAAY;CACZ,cAAc,EACZ,OAAO,EAAE,WAAW,IAAI,EACzB;CAGD,gBAAgB,EACd,MAAM,EAAE,WAAW,WAAW,EAC/B;CACF;AAID,MAAM,iBAAiB,CAAC;CACtB,MAAM,CACJ,EAAE,MAAM,oBAAoB,EAC5B,EAAE,MAAM,4BAA4B,CACrC;CACD,aAAa,EAAE,oBAAoB,QAAQ;CAC5C,EAAE;CACD,MAAM,CACJ,EAAE,MAAM,oBAAoB,EAC5B,EAAE,MAAM,8BAA8B,CACvC;CACD,aAAa,EAAE,oBAAoB,QAAQ;CAC5C,CAAC;AAEF,MAAM,YAAY,IAAIA,qBAAAA,kBAAkB,CACrC,KAAgB,KAAK,CACrB,eAAoC,EAAE,MAAM,eAAe;CAC1D,GAAG;CACH,YAAY,QAAQ;CACpB,qBAAqB,QAAQ,uBAAuB,4BAA4B;CACjF,EAAE,CACF,YAAY;CACX,kBAAkB;CAClB,aAAA,GAAA,qBAAA,2BAAsC;CACtC,qBAAqB,4BAA4B;CAClD,EAAE;AAEL,MAAa,YAAYC,qBAAAA,aAAa,OAAO,UAAU,CAEpD,MAAM,SAAS;CACd,IAAI,CAAC,KAAK,aAAa,MAAM,IAAI,MAAM,2BAA2B;CAElE,OAAO;EAGL,kBAAkB,KAAK,oBAAoB;EAC3C,aAAa,KAAK;EAClB,KAAK,KAAK;EACX;EACD,CAED,OAAO,iBAAiB,QACvB,IAAI,WAAW,WAAW,eAAe,CAC1C,CAEA,iBAAiB,OAAO,QAAQ;CAC/B,MAAM,QAAQ,IAAI,SAAS,QAAQ,kBAAkB,EAAE,aAAa;CACpE,IAAI,UAAU,KAAA,GACZ;CAEF,QAAA,GAAA,qBAAA,qBAA2B,KAAK;EAC9B,YAAY,IAAI,KAAK;EACrB,SAAS,IAAIC,qBAAAA,oBAAoB,MAAM,CACpC,eAAe,CACf,KAAK,YAAY;GAAE;GAAQ,WAAW;GAAM,EAAE;EAClD,CAAC;EACF,CASD,iBAAiB,gBAAgB,QAAkC;CAClE,MAAM,QAAQ,IAAI,SAAS,QAAQ,kBAAkB,EAAE,aAAa;CACpE,IAAI,UAAU,KAAA,GAAW,OAAO,KAAA;CAChC,QAAA,GAAA,qBAAA,uBAA6B,KAAK,MAAM;EACxC,CAED,OAAO,qBAAqB,QAAwC;CACnE,MAAM,QAAQ,IAAI,SAAS,QAAQ,kBAAkB,EAAE,aAAa;CACpE,IAAI,UAAU,KAAA,KAAa,MAAM,WAAW,GAAG,OAAO,KAAA;CACtD,OAAO,MAAM,KAAK,OAAO;EAAE,UAAU,EAAE;EAAI,MAAM,EAAE;EAAM,EAAE;EAC3D,CAED,OAAO,cAAc,QAAQ,IAAI,SAAS,mBAAmB,KAAK,MAAM,CAExE,YAAY,qBAAqB,CAEjC,UAAU,QAAQ;CACjB,IAAI,IAAI,KAAK,kBAAkB,OAAO,IAAI,KAAK;CAC/C,OAAO;EACP,CAED,UAAU,MAAM,CACf;CAAE,MAAM;CAAQ,MAAM;CAAK,OAAO;CAAS,EAC3C;CAAE,MAAM;CAAQ,MAAM;CAAc,OAAO;CAAsB,CAClE,CAAC,CAED,MAAM"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 import * as _$_platforma_sdk_model0 from "@platforma-sdk/model";
-import { PlDataTableStateV2, PlRef } from "@platforma-sdk/model";
+import { PFrameHandle, PlDataTableStateV2, PlRef } from "@platforma-sdk/model";
 import * as _$_milaboratories_helpers0 from "@milaboratories/helpers";
+import { GraphMakerState } from "@milaboratories/graph-maker";
 export * from "@milaboratories/helpers";
 
 //#region src/index.d.ts
@@ -9,7 +10,10 @@ type BlockData = {
   inputAnchor?: PlRef;
   mem?: number;
   tableState: PlDataTableStateV2;
+  graphStateHistogram: GraphMakerState;
 };
+declare const HUMANNESS_SCORE_COLUMN = "pl7.app/humannessScore";
+declare const defaultGraphStateHistogram: () => GraphMakerState;
 declare const platforma: _$_platforma_sdk_model0.PlatformaExtended<_$_platforma_sdk_model0.PlatformaV3<BlockData, {
   customBlockLabel: string;
   inputAnchor: Readonly<{
@@ -33,7 +37,7 @@ declare const platforma: _$_platforma_sdk_model0.PlatformaExtended<_$_platforma_
   pt: _$_platforma_sdk_model0.ConfigRenderLambda<{
     sourceId: null | string;
     fullTableHandle?: _$_platforma_sdk_model0.PTableHandle | undefined;
-    fullPframeHandle?: _$_platforma_sdk_model0.PFrameHandle | undefined;
+    fullPframeHandle?: PFrameHandle | undefined;
     visibleTableHandle?: _$_platforma_sdk_model0.PTableHandle | undefined;
     defaultFilters?: _$_milaboratories_helpers0.Nil | {
       type: "or";
@@ -1679,9 +1683,46 @@ declare const platforma: _$_platforma_sdk_model0.PlatformaExtended<_$_platforma_
   } | undefined> & {
     withStatus: true;
   };
+} & {
+  histogramPf: _$_platforma_sdk_model0.ConfigRenderLambda<PFrameHandle | undefined> & {
+    withStatus: true;
+  };
+} & {
+  histogramPfPcols: _$_platforma_sdk_model0.ConfigRenderLambda<{
+    readonly columnId: _$_platforma_sdk_model0.PObjectId;
+    readonly spec: {
+      readonly kind: "PColumn";
+      readonly name: string;
+      readonly domain?: {
+        [x: string]: string;
+      } | undefined;
+      readonly contextDomain?: {
+        [x: string]: string;
+      } | undefined;
+      readonly annotations?: {
+        [x: string]: string;
+      } | undefined;
+      readonly valueType: "Int" | "Long" | "Float" | "Double" | "String" | "Bytes";
+      readonly parentAxes?: number[] | undefined;
+      readonly axesSpec: {
+        readonly type: _$_platforma_sdk_model0.AxisValueType;
+        readonly name: string;
+        readonly domain?: {
+          [x: string]: string;
+        } | undefined;
+        readonly contextDomain?: {
+          [x: string]: string;
+        } | undefined;
+        readonly annotations?: {
+          [x: string]: string;
+        } | undefined;
+        readonly parentAxes?: number[] | undefined;
+      }[];
+    };
+  }[] | undefined>;
 } & {
   isRunning: _$_platforma_sdk_model0.ConfigRenderLambda<boolean>;
-}>, "/", {}, _$_platforma_sdk_model0.BlockDefaultUiServices>>;
+}>, "/" | "/histogram", {}, _$_platforma_sdk_model0.BlockDefaultUiServices>>;
 //#endregion
-export { BlockData, platforma };
+export { BlockData, HUMANNESS_SCORE_COLUMN, defaultGraphStateHistogram, platforma };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;KAuBY,SAAA;EACV,gBAAA;EACA,WAAA,GAAc,KAAA;EACd,GAAA;EACA,UAAA,EAAY,kBAAA;AAAA;AAAA,cAcD,SAAA,EAAS,uBAAA,CAAA,iBAAA,yBAAA,WAAA,CAAA,SAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;KA4BY,SAAA;EACV,gBAAA;EACA,WAAA,GAAc,KAAA;EACd,GAAA;EACA,UAAA,EAAY,kBAAA;EAEZ,mBAAA,EAAqB,eAAA;AAAA;AAAA,cAIV,sBAAA;AAAA,cAEA,0BAAA,QAAiC,eAAA;AAAA,cA2CjC,SAAA,EAAS,uBAAA,CAAA,iBAAA,yBAAA,WAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;gBAAA"}

package/dist/index.js

@@ -1,27 +1,38 @@
-import { ArrayColumnProvider, BlockModelV3, DataModelBuilder, createPlDataTableStateV2, createPlDataTableV3 } from "@platforma-sdk/model";
+import { ArrayColumnProvider, BlockModelV3, DataModelBuilder, createPFrameForGraphs, createPlDataTableStateV2, createPlDataTableV3 } from "@platforma-sdk/model";
 //#region src/index.ts
+const HUMANNESS_SCORE_COLUMN = "pl7.app/humannessScore";
+const defaultGraphStateHistogram = () => ({
+	title: "Humanness Score Distribution",
+	template: "bins",
+	currentTab: null,
+	axesSettings: { other: { binsCount: 20 } },
+	layersSettings: { bins: { fillColor: "#2D93FA" } }
+});
+const inputSelectors = [{
+	axes: [{ name: "pl7.app/sampleId" }, { name: "pl7.app/vdj/clonotypeKey" }],
+	annotations: { "pl7.app/isAnchor": "true" }
+}, {
+	axes: [{ name: "pl7.app/sampleId" }, { name: "pl7.app/vdj/scClonotypeKey" }],
+	annotations: { "pl7.app/isAnchor": "true" }
+}];
 const dataModel = new DataModelBuilder().from("v1").upgradeLegacy(({ args, uiState }) => ({
 	...args,
-	tableState: uiState.tableState
+	tableState: uiState.tableState,
+	graphStateHistogram: uiState.graphStateHistogram ?? defaultGraphStateHistogram()
 })).init(() => ({
 	customBlockLabel: "",
-	tableState: createPlDataTableStateV2()
+	tableState: createPlDataTableStateV2(),
+	graphStateHistogram: defaultGraphStateHistogram()
 }));
 const platforma = BlockModelV3.create(dataModel).args((data) => {
 	if (!data.inputAnchor) throw new Error("Input anchor is required");
 	return {
-		customBlockLabel: data.customBlockLabel || "Humanness Score",
+		customBlockLabel: data.customBlockLabel || "",
 		inputAnchor: data.inputAnchor,
 		mem: data.mem
 	};
-}).output("inputOptions", (ctx) => ctx.resultPool.getOptions([{
-	axes: [{ name: "pl7.app/sampleId" }, { name: "pl7.app/vdj/clonotypeKey" }],
-	annotations: { "pl7.app/isAnchor": "true" }
-}, {
-	axes: [{ name: "pl7.app/sampleId" }, { name: "pl7.app/vdj/scClonotypeKey" }],
-	annotations: { "pl7.app/isAnchor": "true" }
-}])).outputWithStatus("pt", (ctx) => {
-	const pCols = ctx.outputs?.resolve("outputLiabilities")?.getPColumns();
+}).output("inputOptions", (ctx) => ctx.resultPool.getOptions(inputSelectors)).outputWithStatus("pt", (ctx) => {
+	const pCols = ctx.outputs?.resolve("outputHumanness")?.getPColumns();
 	if (pCols === void 0) return;
 	return createPlDataTableV3(ctx, {
 		tableState: ctx.data.tableState,
@@ -30,12 +41,30 @@ const platforma = BlockModelV3.create(dataModel).args((data) => {
 			isPrimary: true
 		}))
 	});
-}).output("isRunning", (ctx) => ctx.outputs?.getIsReadyOrError() === false).title(() => "Humanness Score").subtitle((ctx) => ctx.data.customBlockLabel || "Humanness Score").sections((_) => [{
+}).outputWithStatus("histogramPf", (ctx) => {
+	const pCols = ctx.outputs?.resolve("outputHumanness")?.getPColumns();
+	if (pCols === void 0) return void 0;
+	return createPFrameForGraphs(ctx, pCols);
+}).output("histogramPfPcols", (ctx) => {
+	const pCols = ctx.outputs?.resolve("outputHumanness")?.getPColumns();
+	if (pCols === void 0 || pCols.length === 0) return void 0;
+	return pCols.map((c) => ({
+		columnId: c.id,
+		spec: c.spec
+	}));
+}).output("isRunning", (ctx) => ctx.outputs?.getIsReadyOrError() === false).title(() => "Humanization Score").subtitle((ctx) => {
+	if (ctx.data.customBlockLabel) return ctx.data.customBlockLabel;
+	return "Humanization Score";
+}).sections((_) => [{
 	type: "link",
 	href: "/",
 	label: "Table"
+}, {
+	type: "link",
+	href: "/histogram",
+	label: "Score Distribution"
 }]).done();
 //#endregion
-export { platforma };
+export { HUMANNESS_SCORE_COLUMN, defaultGraphStateHistogram, platforma };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type {\n  PlDataTableStateV2,\n  PlRef,\n} from '@platforma-sdk/model';\nimport {\n  ArrayColumnProvider,\n  BlockModelV3,\n  DataModelBuilder,\n  createPlDataTableStateV2,\n  createPlDataTableV3,\n} from '@platforma-sdk/model';\nexport type * from '@milaboratories/helpers';\n\ntype OldArgs = {\n  customBlockLabel: string;\n  inputAnchor?: PlRef;\n  mem?: number;\n};\n\ntype OldUiState = {\n  tableState: PlDataTableStateV2;\n};\n\nexport type BlockData = {\n  customBlockLabel: string;\n  inputAnchor?: PlRef;\n  mem?: number;\n  tableState: PlDataTableStateV2;\n};\n\nconst dataModel = new DataModelBuilder()\n  .from<BlockData>('v1')\n  .upgradeLegacy<OldArgs, OldUiState>(({ args, uiState }) => ({\n    ...args,\n    tableState: uiState.tableState,\n  }))\n  .init(() => ({\n    customBlockLabel: '',\n    tableState: createPlDataTableStateV2(),\n  }));\n\nexport const platforma = BlockModelV3.create(dataModel)\n\n  .args((data) => {\n    if (!data.inputAnchor) throw new Error('Input anchor is required');\n\n    return {\n      customBlockLabel: data.customBlockLabel || 'Humanness Score',\n      inputAnchor: data.inputAnchor,\n      mem: data.mem,\n    };\n  })\n\n  .output('inputOptions', (ctx) =>\n    ctx.resultPool.getOptions([{\n      axes: [\n        { name: 'pl7.app/sampleId' },\n        { name: 'pl7.app/vdj/clonotypeKey' },\n      ],\n      annotations: { 'pl7.app/isAnchor': 'true' },\n    }, {\n      axes: [\n        { name: 'pl7.app/sampleId' },\n        { name: 'pl7.app/vdj/scClonotypeKey' },\n      ],\n      annotations: { 'pl7.app/isAnchor': 'true' },\n    }]),\n  )\n\n  .outputWithStatus('pt', (ctx) => {\n    const pCols = ctx.outputs?.resolve('outputLiabilities')?.getPColumns();\n    if (pCols === undefined) {\n      return undefined;\n    }\n    return createPlDataTableV3(ctx, {\n      tableState: ctx.data.tableState,\n      columns: new ArrayColumnProvider(pCols)\n        .getAllColumns()\n        .map((column) => ({ column, isPrimary: true })),\n    });\n  })\n\n  .output('isRunning', (ctx) => ctx.outputs?.getIsReadyOrError() === false)\n\n  .title(() => 'Humanness Score')\n\n  .subtitle((ctx) => ctx.data.customBlockLabel || 'Humanness Score')\n\n  .sections((_) => [\n    { type: 'link', href: '/', label: 'Table' },\n  ])\n\n  .done();\n"],"mappings":";;AA8BA,MAAM,YAAY,IAAI,kBAAkB,CACrC,KAAgB,KAAK,CACrB,eAAoC,EAAE,MAAM,eAAe;CAC1D,GAAG;CACH,YAAY,QAAQ;CACrB,EAAE,CACF,YAAY;CACX,kBAAkB;CAClB,YAAY,0BAA0B;CACvC,EAAE;AAEL,MAAa,YAAY,aAAa,OAAO,UAAU,CAEpD,MAAM,SAAS;CACd,IAAI,CAAC,KAAK,aAAa,MAAM,IAAI,MAAM,2BAA2B;CAElE,OAAO;EACL,kBAAkB,KAAK,oBAAoB;EAC3C,aAAa,KAAK;EAClB,KAAK,KAAK;EACX;EACD,CAED,OAAO,iBAAiB,QACvB,IAAI,WAAW,WAAW,CAAC;CACzB,MAAM,CACJ,EAAE,MAAM,oBAAoB,EAC5B,EAAE,MAAM,4BAA4B,CACrC;CACD,aAAa,EAAE,oBAAoB,QAAQ;CAC5C,EAAE;CACD,MAAM,CACJ,EAAE,MAAM,oBAAoB,EAC5B,EAAE,MAAM,8BAA8B,CACvC;CACD,aAAa,EAAE,oBAAoB,QAAQ;CAC5C,CAAC,CAAC,CACJ,CAEA,iBAAiB,OAAO,QAAQ;CAC/B,MAAM,QAAQ,IAAI,SAAS,QAAQ,oBAAoB,EAAE,aAAa;CACtE,IAAI,UAAU,KAAA,GACZ;CAEF,OAAO,oBAAoB,KAAK;EAC9B,YAAY,IAAI,KAAK;EACrB,SAAS,IAAI,oBAAoB,MAAM,CACpC,eAAe,CACf,KAAK,YAAY;GAAE;GAAQ,WAAW;GAAM,EAAE;EAClD,CAAC;EACF,CAED,OAAO,cAAc,QAAQ,IAAI,SAAS,mBAAmB,KAAK,MAAM,CAExE,YAAY,kBAAkB,CAE9B,UAAU,QAAQ,IAAI,KAAK,oBAAoB,kBAAkB,CAEjE,UAAU,MAAM,CACf;CAAE,MAAM;CAAQ,MAAM;CAAK,OAAO;CAAS,CAC5C,CAAC,CAED,MAAM"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { GraphMakerState } from '@milaboratories/graph-maker';\nimport type {\n  PColumnIdAndSpec,\n  PFrameHandle,\n  PlDataTableStateV2,\n  PlRef,\n} from '@platforma-sdk/model';\nimport {\n  ArrayColumnProvider,\n  BlockModelV3,\n  DataModelBuilder,\n  createPFrameForGraphs,\n  createPlDataTableStateV2,\n  createPlDataTableV3,\n} from '@platforma-sdk/model';\nexport type * from '@milaboratories/helpers';\n\ntype OldArgs = {\n  customBlockLabel: string;\n  inputAnchor?: PlRef;\n  mem?: number;\n};\n\ntype OldUiState = {\n  tableState: PlDataTableStateV2;\n  graphStateHistogram?: GraphMakerState;\n};\n\nexport type BlockData = {\n  customBlockLabel: string;\n  inputAnchor?: PlRef;\n  mem?: number;\n  tableState: PlDataTableStateV2;\n  // Distribution of the per-clonotype humanness score across the whole dataset.\n  graphStateHistogram: GraphMakerState;\n};\n\n// Humanness score column name emitted by `clonotype-process.tpl.tengo`.\nexport const HUMANNESS_SCORE_COLUMN = 'pl7.app/humannessScore';\n\nexport const defaultGraphStateHistogram = (): GraphMakerState => ({\n  title: 'Humanness Score Distribution',\n  template: 'bins',\n  currentTab: null,\n  axesSettings: {\n    other: { binsCount: 20 },\n  },\n  // Give the bars a solid fill instead of the default white — colour values\n  // taken from graph-maker's fixed palette (\"Blue\").\n  layersSettings: {\n    bins: { fillColor: '#2D93FA' },\n  },\n});\n\n// Selectors for the input dataset anchor — shared between `inputOptions`\n// (the dropdown) and `subtitle` (so the default label matches the dataset name).\nconst inputSelectors = [{\n  axes: [\n    { name: 'pl7.app/sampleId' },\n    { name: 'pl7.app/vdj/clonotypeKey' },\n  ],\n  annotations: { 'pl7.app/isAnchor': 'true' },\n}, {\n  axes: [\n    { name: 'pl7.app/sampleId' },\n    { name: 'pl7.app/vdj/scClonotypeKey' },\n  ],\n  annotations: { 'pl7.app/isAnchor': 'true' },\n}];\n\nconst dataModel = new DataModelBuilder()\n  .from<BlockData>('v1')\n  .upgradeLegacy<OldArgs, OldUiState>(({ args, uiState }) => ({\n    ...args,\n    tableState: uiState.tableState,\n    graphStateHistogram: uiState.graphStateHistogram ?? defaultGraphStateHistogram(),\n  }))\n  .init(() => ({\n    customBlockLabel: '',\n    tableState: createPlDataTableStateV2(),\n    graphStateHistogram: defaultGraphStateHistogram(),\n  }));\n\nexport const platforma = BlockModelV3.create(dataModel)\n\n  .args((data) => {\n    if (!data.inputAnchor) throw new Error('Input anchor is required');\n\n    return {\n      // Empty when unset; the workflow falls back to the input dataset name so\n      // the provenance trace label matches the block subtitle.\n      customBlockLabel: data.customBlockLabel || '',\n      inputAnchor: data.inputAnchor,\n      mem: data.mem,\n    };\n  })\n\n  .output('inputOptions', (ctx) =>\n    ctx.resultPool.getOptions(inputSelectors),\n  )\n\n  .outputWithStatus('pt', (ctx) => {\n    const pCols = ctx.outputs?.resolve('outputHumanness')?.getPColumns();\n    if (pCols === undefined) {\n      return undefined;\n    }\n    return createPlDataTableV3(ctx, {\n      tableState: ctx.data.tableState,\n      columns: new ArrayColumnProvider(pCols)\n        .getAllColumns()\n        .map((column) => ({ column, isPrimary: true })),\n    });\n  })\n\n  // --- Score distribution (histogram) ---------------------------------------\n  // One row per clonotype, so the histogram counts UNIQUE clonotypes by humanness\n  // score — it is deliberately NOT weighted by clonotype abundance. The question it\n  // answers is \"how many distinct candidates sit below/above a humanness level\"\n  // (i.e. how much humanization work is there), not \"how human is the repertoire by\n  // read mass\". No human-like threshold line is drawn: this score is a 9-mer\n  // fraction rescaled to 0..100, not a cutoff validated against therapeutic mAbs.\n  .outputWithStatus('histogramPf', (ctx): PFrameHandle | undefined => {\n    const pCols = ctx.outputs?.resolve('outputHumanness')?.getPColumns();\n    if (pCols === undefined) return undefined;\n    return createPFrameForGraphs(ctx, pCols);\n  })\n\n  .output('histogramPfPcols', (ctx): PColumnIdAndSpec[] | undefined => {\n    const pCols = ctx.outputs?.resolve('outputHumanness')?.getPColumns();\n    if (pCols === undefined || pCols.length === 0) return undefined;\n    return pCols.map((c) => ({ columnId: c.id, spec: c.spec }));\n  })\n\n  .output('isRunning', (ctx) => ctx.outputs?.getIsReadyOrError() === false)\n\n  .title(() => 'Humanization Score')\n\n  .subtitle((ctx) => {\n    if (ctx.data.customBlockLabel) return ctx.data.customBlockLabel;\n    return 'Humanization Score';\n  })\n\n  .sections((_) => [\n    { type: 'link', href: '/', label: 'Table' },\n    { type: 'link', href: '/histogram', label: 'Score Distribution' },\n  ])\n\n  .done();\n"],"mappings":";;AAsCA,MAAa,yBAAyB;AAEtC,MAAa,oCAAqD;CAChE,OAAO;CACP,UAAU;CACV,YAAY;CACZ,cAAc,EACZ,OAAO,EAAE,WAAW,IAAI,EACzB;CAGD,gBAAgB,EACd,MAAM,EAAE,WAAW,WAAW,EAC/B;CACF;AAID,MAAM,iBAAiB,CAAC;CACtB,MAAM,CACJ,EAAE,MAAM,oBAAoB,EAC5B,EAAE,MAAM,4BAA4B,CACrC;CACD,aAAa,EAAE,oBAAoB,QAAQ;CAC5C,EAAE;CACD,MAAM,CACJ,EAAE,MAAM,oBAAoB,EAC5B,EAAE,MAAM,8BAA8B,CACvC;CACD,aAAa,EAAE,oBAAoB,QAAQ;CAC5C,CAAC;AAEF,MAAM,YAAY,IAAI,kBAAkB,CACrC,KAAgB,KAAK,CACrB,eAAoC,EAAE,MAAM,eAAe;CAC1D,GAAG;CACH,YAAY,QAAQ;CACpB,qBAAqB,QAAQ,uBAAuB,4BAA4B;CACjF,EAAE,CACF,YAAY;CACX,kBAAkB;CAClB,YAAY,0BAA0B;CACtC,qBAAqB,4BAA4B;CAClD,EAAE;AAEL,MAAa,YAAY,aAAa,OAAO,UAAU,CAEpD,MAAM,SAAS;CACd,IAAI,CAAC,KAAK,aAAa,MAAM,IAAI,MAAM,2BAA2B;CAElE,OAAO;EAGL,kBAAkB,KAAK,oBAAoB;EAC3C,aAAa,KAAK;EAClB,KAAK,KAAK;EACX;EACD,CAED,OAAO,iBAAiB,QACvB,IAAI,WAAW,WAAW,eAAe,CAC1C,CAEA,iBAAiB,OAAO,QAAQ;CAC/B,MAAM,QAAQ,IAAI,SAAS,QAAQ,kBAAkB,EAAE,aAAa;CACpE,IAAI,UAAU,KAAA,GACZ;CAEF,OAAO,oBAAoB,KAAK;EAC9B,YAAY,IAAI,KAAK;EACrB,SAAS,IAAI,oBAAoB,MAAM,CACpC,eAAe,CACf,KAAK,YAAY;GAAE;GAAQ,WAAW;GAAM,EAAE;EAClD,CAAC;EACF,CASD,iBAAiB,gBAAgB,QAAkC;CAClE,MAAM,QAAQ,IAAI,SAAS,QAAQ,kBAAkB,EAAE,aAAa;CACpE,IAAI,UAAU,KAAA,GAAW,OAAO,KAAA;CAChC,OAAO,sBAAsB,KAAK,MAAM;EACxC,CAED,OAAO,qBAAqB,QAAwC;CACnE,MAAM,QAAQ,IAAI,SAAS,QAAQ,kBAAkB,EAAE,aAAa;CACpE,IAAI,UAAU,KAAA,KAAa,MAAM,WAAW,GAAG,OAAO,KAAA;CACtD,OAAO,MAAM,KAAK,OAAO;EAAE,UAAU,EAAE;EAAI,MAAM,EAAE;EAAM,EAAE;EAC3D,CAED,OAAO,cAAc,QAAQ,IAAI,SAAS,mBAAmB,KAAK,MAAM,CAExE,YAAY,qBAAqB,CAEjC,UAAU,QAAQ;CACjB,IAAI,IAAI,KAAK,kBAAkB,OAAO,IAAI,KAAK;CAC/C,OAAO;EACP,CAED,UAAU,MAAM,CACf;CAAE,MAAM;CAAQ,MAAM;CAAK,OAAO;CAAS,EAC3C;CAAE,MAAM;CAAQ,MAAM;CAAc,OAAO;CAAsB,CAClE,CAAC,CAED,MAAM"}