@milaboratories/pf-spec-driver 1.1.0

package/dist/index.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_spec_driver = require('./spec_driver.cjs');
+
+exports.SpecDriver = require_spec_driver.SpecDriver;

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import { SpecDriver } from "./spec_driver.js";
+export { SpecDriver };

package/dist/index.js

@@ -0,0 +1,3 @@
+import { SpecDriver } from "./spec_driver.js";
+
+export { SpecDriver };

package/dist/spec_driver.cjs

@@ -0,0 +1,60 @@
+let _milaboratories_pframes_rs_wasm = require("@milaboratories/pframes-rs-wasm");
+let _milaboratories_pl_model_common = require("@milaboratories/pl-model-common");
+
+//#region src/spec_driver.ts
+/**
+* Manages spec-only PFrame instances (WASM) with handle-based lifecycle.
+*
+* All operations are synchronous — WASM computes results immediately.
+*/
+var SpecDriver = class {
+	frames = /* @__PURE__ */ new Map();
+	createSpecFrame(specs) {
+		const frame = (0, _milaboratories_pframes_rs_wasm.createPFrame)(specs);
+		const handle = crypto.randomUUID();
+		this.frames.set(handle, frame);
+		return handle;
+	}
+	specFrameDiscoverColumns(handle, request) {
+		return this.getFrame(handle).discoverColumns(request);
+	}
+	disposeSpecFrame(handle) {
+		const frame = this.frames.get(handle);
+		if (frame) {
+			frame[Symbol.dispose]();
+			this.frames.delete(handle);
+		}
+	}
+	expandAxes(spec) {
+		return (0, _milaboratories_pframes_rs_wasm.expandAxes)(spec);
+	}
+	collapseAxes(ids) {
+		return (0, _milaboratories_pframes_rs_wasm.collapseAxes)(ids);
+	}
+	findAxis(spec, selector) {
+		return (0, _milaboratories_pframes_rs_wasm.findAxis)(spec, selector);
+	}
+	findTableColumn(tableSpec, selector) {
+		return (0, _milaboratories_pframes_rs_wasm.findTableColumn)(tableSpec, selector);
+	}
+	/** Dispose all managed spec frames. */
+	dispose() {
+		try {
+			for (const frame of this.frames.values()) frame[Symbol.dispose]();
+		} finally {
+			this.frames.clear();
+		}
+	}
+	[Symbol.dispose]() {
+		this.dispose();
+	}
+	getFrame(handle) {
+		const frame = this.frames.get(handle);
+		if (frame === void 0) throw new _milaboratories_pl_model_common.PFrameSpecDriverError(`No such spec frame: ${handle}`);
+		return frame;
+	}
+};
+
+//#endregion
+exports.SpecDriver = SpecDriver;
+//# sourceMappingURL=spec_driver.cjs.map

package/dist/spec_driver.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec_driver.cjs","names":["PFrameSpecDriverError"],"sources":["../src/spec_driver.ts"],"sourcesContent":["import {\n  createPFrame,\n  expandAxes,\n  collapseAxes,\n  findAxis,\n  findTableColumn,\n} from \"@milaboratories/pframes-rs-wasm\";\nimport type { PFrameInternal } from \"@milaboratories/pl-model-middle-layer\";\nimport type {\n  AxesId,\n  AxesSpec,\n  PColumnSpec,\n  PFrameSpecDriver,\n  PTableColumnId,\n  PTableColumnSpec,\n  SingleAxisSelector,\n  SpecFrameHandle,\n  DiscoverColumnsRequest,\n  DiscoverColumnsResponse,\n} from \"@milaboratories/pl-model-common\";\nimport { PFrameSpecDriverError } from \"@milaboratories/pl-model-common\";\n\n/**\n * Manages spec-only PFrame instances (WASM) with handle-based lifecycle.\n *\n * All operations are synchronous — WASM computes results immediately.\n */\nexport class SpecDriver implements PFrameSpecDriver, Disposable {\n  private readonly frames = new Map<SpecFrameHandle, PFrameInternal.PFrameWasmV2>();\n\n  createSpecFrame(specs: Record<string, PColumnSpec>): SpecFrameHandle {\n    // Explicit annotation ensures a WASM version mismatch surfaces at compile time\n    // (skipLibCheck won't validate .d.ts in node_modules, but this assignment will)\n    const frame: PFrameInternal.PFrameWasmV2 = createPFrame(specs);\n    const handle = crypto.randomUUID() as SpecFrameHandle;\n    this.frames.set(handle, frame);\n    return handle;\n  }\n\n  specFrameDiscoverColumns(\n    handle: SpecFrameHandle,\n    request: DiscoverColumnsRequest,\n  ): DiscoverColumnsResponse {\n    return this.getFrame(handle).discoverColumns(request);\n  }\n\n  disposeSpecFrame(handle: SpecFrameHandle): void {\n    const frame = this.frames.get(handle);\n    if (frame) {\n      frame[Symbol.dispose]();\n      this.frames.delete(handle);\n    }\n  }\n\n  expandAxes(spec: AxesSpec): AxesId {\n    return expandAxes(spec);\n  }\n\n  collapseAxes(ids: AxesId): AxesSpec {\n    return collapseAxes(ids);\n  }\n\n  findAxis(spec: AxesSpec, selector: SingleAxisSelector): number {\n    return findAxis(spec, selector);\n  }\n\n  findTableColumn(tableSpec: PTableColumnSpec[], selector: PTableColumnId): number {\n    return findTableColumn(tableSpec, selector);\n  }\n\n  /** Dispose all managed spec frames. */\n  dispose(): void {\n    try {\n      for (const frame of this.frames.values()) {\n        frame[Symbol.dispose]();\n      }\n    } finally {\n      this.frames.clear();\n    }\n  }\n\n  [Symbol.dispose](): void {\n    this.dispose();\n  }\n\n  private getFrame(handle: SpecFrameHandle): PFrameInternal.PFrameWasmV2 {\n    const frame = this.frames.get(handle);\n    if (frame === undefined) throw new PFrameSpecDriverError(`No such spec frame: ${handle}`);\n    return frame;\n  }\n}\n"],"mappings":";;;;;;;;;AA2BA,IAAa,aAAb,MAAgE;CAC9D,AAAiB,yBAAS,IAAI,KAAmD;CAEjF,gBAAgB,OAAqD;EAGnE,MAAM,0DAAkD,MAAM;EAC9D,MAAM,SAAS,OAAO,YAAY;AAClC,OAAK,OAAO,IAAI,QAAQ,MAAM;AAC9B,SAAO;;CAGT,yBACE,QACA,SACyB;AACzB,SAAO,KAAK,SAAS,OAAO,CAAC,gBAAgB,QAAQ;;CAGvD,iBAAiB,QAA+B;EAC9C,MAAM,QAAQ,KAAK,OAAO,IAAI,OAAO;AACrC,MAAI,OAAO;AACT,SAAM,OAAO,UAAU;AACvB,QAAK,OAAO,OAAO,OAAO;;;CAI9B,WAAW,MAAwB;AACjC,yDAAkB,KAAK;;CAGzB,aAAa,KAAuB;AAClC,2DAAoB,IAAI;;CAG1B,SAAS,MAAgB,UAAsC;AAC7D,uDAAgB,MAAM,SAAS;;CAGjC,gBAAgB,WAA+B,UAAkC;AAC/E,8DAAuB,WAAW,SAAS;;;CAI7C,UAAgB;AACd,MAAI;AACF,QAAK,MAAM,SAAS,KAAK,OAAO,QAAQ,CACtC,OAAM,OAAO,UAAU;YAEjB;AACR,QAAK,OAAO,OAAO;;;CAIvB,CAAC,OAAO,WAAiB;AACvB,OAAK,SAAS;;CAGhB,AAAQ,SAAS,QAAsD;EACrE,MAAM,QAAQ,KAAK,OAAO,IAAI,OAAO;AACrC,MAAI,UAAU,OAAW,OAAM,IAAIA,sDAAsB,uBAAuB,SAAS;AACzF,SAAO"}

package/dist/spec_driver.d.ts

@@ -0,0 +1,25 @@
+import { AxesId, AxesSpec, DiscoverColumnsRequest, DiscoverColumnsResponse, PColumnSpec, PFrameSpecDriver, PTableColumnId, PTableColumnSpec, SingleAxisSelector, SpecFrameHandle } from "@milaboratories/pl-model-common";
+
+//#region src/spec_driver.d.ts
+/**
+ * Manages spec-only PFrame instances (WASM) with handle-based lifecycle.
+ *
+ * All operations are synchronous — WASM computes results immediately.
+ */
+declare class SpecDriver implements PFrameSpecDriver, Disposable {
+  private readonly frames;
+  createSpecFrame(specs: Record<string, PColumnSpec>): SpecFrameHandle;
+  specFrameDiscoverColumns(handle: SpecFrameHandle, request: DiscoverColumnsRequest): DiscoverColumnsResponse;
+  disposeSpecFrame(handle: SpecFrameHandle): void;
+  expandAxes(spec: AxesSpec): AxesId;
+  collapseAxes(ids: AxesId): AxesSpec;
+  findAxis(spec: AxesSpec, selector: SingleAxisSelector): number;
+  findTableColumn(tableSpec: PTableColumnSpec[], selector: PTableColumnId): number;
+  /** Dispose all managed spec frames. */
+  dispose(): void;
+  [Symbol.dispose](): void;
+  private getFrame;
+}
+//#endregion
+export { SpecDriver };
+//# sourceMappingURL=spec_driver.d.ts.map

package/dist/spec_driver.js

@@ -0,0 +1,60 @@
+import { collapseAxes, createPFrame, expandAxes, findAxis, findTableColumn } from "@milaboratories/pframes-rs-wasm";
+import { PFrameSpecDriverError } from "@milaboratories/pl-model-common";
+
+//#region src/spec_driver.ts
+/**
+* Manages spec-only PFrame instances (WASM) with handle-based lifecycle.
+*
+* All operations are synchronous — WASM computes results immediately.
+*/
+var SpecDriver = class {
+	frames = /* @__PURE__ */ new Map();
+	createSpecFrame(specs) {
+		const frame = createPFrame(specs);
+		const handle = crypto.randomUUID();
+		this.frames.set(handle, frame);
+		return handle;
+	}
+	specFrameDiscoverColumns(handle, request) {
+		return this.getFrame(handle).discoverColumns(request);
+	}
+	disposeSpecFrame(handle) {
+		const frame = this.frames.get(handle);
+		if (frame) {
+			frame[Symbol.dispose]();
+			this.frames.delete(handle);
+		}
+	}
+	expandAxes(spec) {
+		return expandAxes(spec);
+	}
+	collapseAxes(ids) {
+		return collapseAxes(ids);
+	}
+	findAxis(spec, selector) {
+		return findAxis(spec, selector);
+	}
+	findTableColumn(tableSpec, selector) {
+		return findTableColumn(tableSpec, selector);
+	}
+	/** Dispose all managed spec frames. */
+	dispose() {
+		try {
+			for (const frame of this.frames.values()) frame[Symbol.dispose]();
+		} finally {
+			this.frames.clear();
+		}
+	}
+	[Symbol.dispose]() {
+		this.dispose();
+	}
+	getFrame(handle) {
+		const frame = this.frames.get(handle);
+		if (frame === void 0) throw new PFrameSpecDriverError(`No such spec frame: ${handle}`);
+		return frame;
+	}
+};
+
+//#endregion
+export { SpecDriver };
+//# sourceMappingURL=spec_driver.js.map

package/dist/spec_driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec_driver.js","names":[],"sources":["../src/spec_driver.ts"],"sourcesContent":["import {\n  createPFrame,\n  expandAxes,\n  collapseAxes,\n  findAxis,\n  findTableColumn,\n} from \"@milaboratories/pframes-rs-wasm\";\nimport type { PFrameInternal } from \"@milaboratories/pl-model-middle-layer\";\nimport type {\n  AxesId,\n  AxesSpec,\n  PColumnSpec,\n  PFrameSpecDriver,\n  PTableColumnId,\n  PTableColumnSpec,\n  SingleAxisSelector,\n  SpecFrameHandle,\n  DiscoverColumnsRequest,\n  DiscoverColumnsResponse,\n} from \"@milaboratories/pl-model-common\";\nimport { PFrameSpecDriverError } from \"@milaboratories/pl-model-common\";\n\n/**\n * Manages spec-only PFrame instances (WASM) with handle-based lifecycle.\n *\n * All operations are synchronous — WASM computes results immediately.\n */\nexport class SpecDriver implements PFrameSpecDriver, Disposable {\n  private readonly frames = new Map<SpecFrameHandle, PFrameInternal.PFrameWasmV2>();\n\n  createSpecFrame(specs: Record<string, PColumnSpec>): SpecFrameHandle {\n    // Explicit annotation ensures a WASM version mismatch surfaces at compile time\n    // (skipLibCheck won't validate .d.ts in node_modules, but this assignment will)\n    const frame: PFrameInternal.PFrameWasmV2 = createPFrame(specs);\n    const handle = crypto.randomUUID() as SpecFrameHandle;\n    this.frames.set(handle, frame);\n    return handle;\n  }\n\n  specFrameDiscoverColumns(\n    handle: SpecFrameHandle,\n    request: DiscoverColumnsRequest,\n  ): DiscoverColumnsResponse {\n    return this.getFrame(handle).discoverColumns(request);\n  }\n\n  disposeSpecFrame(handle: SpecFrameHandle): void {\n    const frame = this.frames.get(handle);\n    if (frame) {\n      frame[Symbol.dispose]();\n      this.frames.delete(handle);\n    }\n  }\n\n  expandAxes(spec: AxesSpec): AxesId {\n    return expandAxes(spec);\n  }\n\n  collapseAxes(ids: AxesId): AxesSpec {\n    return collapseAxes(ids);\n  }\n\n  findAxis(spec: AxesSpec, selector: SingleAxisSelector): number {\n    return findAxis(spec, selector);\n  }\n\n  findTableColumn(tableSpec: PTableColumnSpec[], selector: PTableColumnId): number {\n    return findTableColumn(tableSpec, selector);\n  }\n\n  /** Dispose all managed spec frames. */\n  dispose(): void {\n    try {\n      for (const frame of this.frames.values()) {\n        frame[Symbol.dispose]();\n      }\n    } finally {\n      this.frames.clear();\n    }\n  }\n\n  [Symbol.dispose](): void {\n    this.dispose();\n  }\n\n  private getFrame(handle: SpecFrameHandle): PFrameInternal.PFrameWasmV2 {\n    const frame = this.frames.get(handle);\n    if (frame === undefined) throw new PFrameSpecDriverError(`No such spec frame: ${handle}`);\n    return frame;\n  }\n}\n"],"mappings":";;;;;;;;;AA2BA,IAAa,aAAb,MAAgE;CAC9D,AAAiB,yBAAS,IAAI,KAAmD;CAEjF,gBAAgB,OAAqD;EAGnE,MAAM,QAAqC,aAAa,MAAM;EAC9D,MAAM,SAAS,OAAO,YAAY;AAClC,OAAK,OAAO,IAAI,QAAQ,MAAM;AAC9B,SAAO;;CAGT,yBACE,QACA,SACyB;AACzB,SAAO,KAAK,SAAS,OAAO,CAAC,gBAAgB,QAAQ;;CAGvD,iBAAiB,QAA+B;EAC9C,MAAM,QAAQ,KAAK,OAAO,IAAI,OAAO;AACrC,MAAI,OAAO;AACT,SAAM,OAAO,UAAU;AACvB,QAAK,OAAO,OAAO,OAAO;;;CAI9B,WAAW,MAAwB;AACjC,SAAO,WAAW,KAAK;;CAGzB,aAAa,KAAuB;AAClC,SAAO,aAAa,IAAI;;CAG1B,SAAS,MAAgB,UAAsC;AAC7D,SAAO,SAAS,MAAM,SAAS;;CAGjC,gBAAgB,WAA+B,UAAkC;AAC/E,SAAO,gBAAgB,WAAW,SAAS;;;CAI7C,UAAgB;AACd,MAAI;AACF,QAAK,MAAM,SAAS,KAAK,OAAO,QAAQ,CACtC,OAAM,OAAO,UAAU;YAEjB;AACR,QAAK,OAAO,OAAO;;;CAIvB,CAAC,OAAO,WAAiB;AACvB,OAAK,SAAS;;CAGhB,AAAQ,SAAS,QAAsD;EACrE,MAAM,QAAQ,KAAK,OAAO,IAAI,OAAO;AACrC,MAAI,UAAU,OAAW,OAAM,IAAI,sBAAsB,uBAAuB,SAAS;AACzF,SAAO"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@milaboratories/pf-spec-driver",
+  "version": "1.1.0",
+  "description": "PSpecDriver implementation: spec-only PFrame operations via WASM",
+  "keywords": [],
+  "license": "UNLICENSED",
+  "files": [
+    "./dist/**/*",
+    "./src/**/*"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "dependencies": {
+    "@milaboratories/pframes-rs-wasm": "1.1.15",
+    "@milaboratories/pl-model-middle-layer": "1.16.0",
+    "@milaboratories/pl-model-common": "1.29.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-istanbul": "^4.0.18",
+    "typescript": "~5.9.3",
+    "vitest": "^4.0.18",
+    "@milaboratories/ts-configs": "1.2.2",
+    "@milaboratories/build-configs": "1.5.2",
+    "@milaboratories/ts-builder": "1.3.0"
+  },
+  "scripts": {
+    "build": "ts-builder build --target node",
+    "watch": "ts-builder build --target node --watch",
+    "check": "ts-builder check --target node",
+    "formatter:check": "ts-builder formatter --check",
+    "linter:check": "ts-builder linter --check",
+    "types:check": "ts-builder type-check --target node",
+    "test": "vitest run --coverage",
+    "do-pack": "rm -f *.tgz && pnpm pack && mv *.tgz package.tgz",
+    "fmt": "ts-builder format"
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export { SpecDriver } from "./spec_driver";

package/src/spec_driver.test.ts

@@ -0,0 +1,38 @@
+import type { AxisSpec, PColumnSpec } from "@milaboratories/pl-model-common";
+import { describe, expect, test } from "vitest";
+import { SpecDriver } from "./spec_driver";
+
+function createSpec(name: string, axesSpec?: AxisSpec[]): PColumnSpec {
+  return {
+    kind: "PColumn",
+    name,
+    valueType: "Int",
+    axesSpec: axesSpec ?? [{ name: "id", type: "String" } as AxisSpec],
+    annotations: {},
+  } as PColumnSpec;
+}
+
+describe("SpecDriver", () => {
+  test("discoverColumns returns all columns with no filters", () => {
+    using driver = new SpecDriver();
+    const handle = driver.createSpecFrame({
+      col1: createSpec("col1"),
+      col2: createSpec("col2"),
+    });
+
+    const response = driver.specFrameDiscoverColumns(handle, {
+      axes: [],
+      maxHops: 0,
+      constraints: {
+        allowFloatingSourceAxes: true,
+        allowFloatingHitAxes: true,
+        allowSourceQualifications: false,
+        allowHitQualifications: false,
+      },
+    });
+
+    expect(response.hits).toHaveLength(2);
+    const names = response.hits.map((h) => h.hit.spec.name).sort();
+    expect(names).toEqual(["col1", "col2"]);
+  });
+});

package/src/spec_driver.ts

@@ -0,0 +1,91 @@
+import {
+  createPFrame,
+  expandAxes,
+  collapseAxes,
+  findAxis,
+  findTableColumn,
+} from "@milaboratories/pframes-rs-wasm";
+import type { PFrameInternal } from "@milaboratories/pl-model-middle-layer";
+import type {
+  AxesId,
+  AxesSpec,
+  PColumnSpec,
+  PFrameSpecDriver,
+  PTableColumnId,
+  PTableColumnSpec,
+  SingleAxisSelector,
+  SpecFrameHandle,
+  DiscoverColumnsRequest,
+  DiscoverColumnsResponse,
+} from "@milaboratories/pl-model-common";
+import { PFrameSpecDriverError } from "@milaboratories/pl-model-common";
+
+/**
+ * Manages spec-only PFrame instances (WASM) with handle-based lifecycle.
+ *
+ * All operations are synchronous — WASM computes results immediately.
+ */
+export class SpecDriver implements PFrameSpecDriver, Disposable {
+  private readonly frames = new Map<SpecFrameHandle, PFrameInternal.PFrameWasmV2>();
+
+  createSpecFrame(specs: Record<string, PColumnSpec>): SpecFrameHandle {
+    // Explicit annotation ensures a WASM version mismatch surfaces at compile time
+    // (skipLibCheck won't validate .d.ts in node_modules, but this assignment will)
+    const frame: PFrameInternal.PFrameWasmV2 = createPFrame(specs);
+    const handle = crypto.randomUUID() as SpecFrameHandle;
+    this.frames.set(handle, frame);
+    return handle;
+  }
+
+  specFrameDiscoverColumns(
+    handle: SpecFrameHandle,
+    request: DiscoverColumnsRequest,
+  ): DiscoverColumnsResponse {
+    return this.getFrame(handle).discoverColumns(request);
+  }
+
+  disposeSpecFrame(handle: SpecFrameHandle): void {
+    const frame = this.frames.get(handle);
+    if (frame) {
+      frame[Symbol.dispose]();
+      this.frames.delete(handle);
+    }
+  }
+
+  expandAxes(spec: AxesSpec): AxesId {
+    return expandAxes(spec);
+  }
+
+  collapseAxes(ids: AxesId): AxesSpec {
+    return collapseAxes(ids);
+  }
+
+  findAxis(spec: AxesSpec, selector: SingleAxisSelector): number {
+    return findAxis(spec, selector);
+  }
+
+  findTableColumn(tableSpec: PTableColumnSpec[], selector: PTableColumnId): number {
+    return findTableColumn(tableSpec, selector);
+  }
+
+  /** Dispose all managed spec frames. */
+  dispose(): void {
+    try {
+      for (const frame of this.frames.values()) {
+        frame[Symbol.dispose]();
+      }
+    } finally {
+      this.frames.clear();
+    }
+  }
+
+  [Symbol.dispose](): void {
+    this.dispose();
+  }
+
+  private getFrame(handle: SpecFrameHandle): PFrameInternal.PFrameWasmV2 {
+    const frame = this.frames.get(handle);
+    if (frame === undefined) throw new PFrameSpecDriverError(`No such spec frame: ${handle}`);
+    return frame;
+  }
+}