@milaboratories/pf-spec 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,40 @@
+import { collapse, expand, find } from "./axes.js";
+import { build } from "./build-query.js";
+import { LegacyQuery, PFrame } from "./p-frame.js";
+import { rewriteLegacyFilters as rewriteLegacyFilters$1 } from "./rewrite-filters.js";
+import { findColumn } from "./table.js";
+import { PColumnSpec } from "@milaboratories/pl-model-common";
+
+//#region src/index.d.ts
+/** Creates a {@link PFrame} from a map of column ids to column specifications. */
+declare const createPFrame: (spec: Record<string, PColumnSpec>) => PFrame;
+/** Expands an `AxesSpec` into `AxesId`s and resolves the parent information. */
+declare const expandAxes: typeof expand;
+/** This operation is the inverse of {@link expandAxes}. */
+declare const collapseAxes: typeof collapse;
+/** Returns the index of the axis that matches `selector`, or -1 if no axis matches. */
+declare const findAxis: typeof find;
+/**
+ * Returns the index of the table column that matches `selector`. It returns -1 if no
+ * column matches. A table spec indexes the axes first and then the columns.
+ */
+declare const findTableColumn: typeof findColumn;
+/**
+ * Assembles a `SpecQueryJoinEntry` from a terminal column and an ordered path of
+ * steps. The steps are linker hops and filter joins.
+ *
+ * The operation is a right fold over `path`, and it starts at the column. Each
+ * `linker` step wraps the current subquery as a `linkerJoin`. Each `filter` step
+ * wraps the current subquery as an `innerJoin` with the filter column.
+ * `qualifications` annotate only the outermost entry.
+ */
+declare const buildQuery: typeof build;
+/**
+ * Upgrades the selector-based legacy record filters into index-based boolean
+ * expressions for the data layer. It resolves them against the given unified table
+ * spec.
+ */
+declare const rewriteLegacyFilters: typeof rewriteLegacyFilters$1;
+//#endregion
+export { type LegacyQuery, PFrame, buildQuery, collapseAxes, createPFrame, expandAxes, findAxis, findTableColumn, rewriteLegacyFilters };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;cAUa,YAAA,GAAgB,IAAA,EAAM,MAAA,SAAe,WAAA,MAAe,MAAA;;cAGpD,UAAA,SAAU,MAAc;;cAGxB,YAAA,SAAY,QAAgB;;cAG5B,QAAA,SAAQ,IAAY;;;;;cAMpB,eAAA,SAAe,UAAmB;;AAf4C;AAG3F;;;;AAAqC;AAGrC;;cAoBa,UAAA,SAAU,KAAyB;;AApBP;AAGzC;;;cAwBa,oBAAA,SAAoB,sBAA4C"}

package/dist/index.js

@@ -0,0 +1,39 @@
+import { collapse, expand, find } from "./axes.js";
+import { build } from "./build-query.js";
+import { PFrame } from "./p-frame.js";
+import { rewriteLegacyFilters as rewriteLegacyFilters$1 } from "./rewrite-filters.js";
+import { findColumn } from "./table.js";
+//#region src/index.ts
+/** Creates a {@link PFrame} from a map of column ids to column specifications. */
+const createPFrame = (spec) => new PFrame(spec);
+/** Expands an `AxesSpec` into `AxesId`s and resolves the parent information. */
+const expandAxes = expand;
+/** This operation is the inverse of {@link expandAxes}. */
+const collapseAxes = collapse;
+/** Returns the index of the axis that matches `selector`, or -1 if no axis matches. */
+const findAxis = find;
+/**
+* Returns the index of the table column that matches `selector`. It returns -1 if no
+* column matches. A table spec indexes the axes first and then the columns.
+*/
+const findTableColumn = findColumn;
+/**
+* Assembles a `SpecQueryJoinEntry` from a terminal column and an ordered path of
+* steps. The steps are linker hops and filter joins.
+*
+* The operation is a right fold over `path`, and it starts at the column. Each
+* `linker` step wraps the current subquery as a `linkerJoin`. Each `filter` step
+* wraps the current subquery as an `innerJoin` with the filter column.
+* `qualifications` annotate only the outermost entry.
+*/
+const buildQuery = build;
+/**
+* Upgrades the selector-based legacy record filters into index-based boolean
+* expressions for the data layer. It resolves them against the given unified table
+* spec.
+*/
+const rewriteLegacyFilters = rewriteLegacyFilters$1;
+//#endregion
+export { PFrame, buildQuery, collapseAxes, createPFrame, expandAxes, findAxis, findTableColumn, rewriteLegacyFilters };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["axes.expand","axes.collapse","axes.find","table.findColumn","buildQueryModule.build","rewriteFiltersModule.rewriteLegacyFilters"],"sources":["../src/index.ts"],"sourcesContent":["import type { PColumnSpec } from \"@milaboratories/pl-model-common\";\nimport * as axes from \"./axes.ts\";\nimport * as buildQueryModule from \"./build-query.ts\";\nimport { PFrame } from \"./p-frame.ts\";\nimport * as rewriteFiltersModule from \"./rewrite-filters.ts\";\nimport * as table from \"./table.ts\";\n\nexport { PFrame, type LegacyQuery } from \"./p-frame\";\n\n/** Creates a {@link PFrame} from a map of column ids to column specifications. */\nexport const createPFrame = (spec: Record<string, PColumnSpec>): PFrame => new PFrame(spec);\n\n/** Expands an `AxesSpec` into `AxesId`s and resolves the parent information. */\nexport const expandAxes = axes.expand;\n\n/** This operation is the inverse of {@link expandAxes}. */\nexport const collapseAxes = axes.collapse;\n\n/** Returns the index of the axis that matches `selector`, or -1 if no axis matches. */\nexport const findAxis = axes.find;\n\n/**\n * Returns the index of the table column that matches `selector`. It returns -1 if no\n * column matches. A table spec indexes the axes first and then the columns.\n */\nexport const findTableColumn = table.findColumn;\n\n/**\n * Assembles a `SpecQueryJoinEntry` from a terminal column and an ordered path of\n * steps. The steps are linker hops and filter joins.\n *\n * The operation is a right fold over `path`, and it starts at the column. Each\n * `linker` step wraps the current subquery as a `linkerJoin`. Each `filter` step\n * wraps the current subquery as an `innerJoin` with the filter column.\n * `qualifications` annotate only the outermost entry.\n */\nexport const buildQuery = buildQueryModule.build;\n\n/**\n * Upgrades the selector-based legacy record filters into index-based boolean\n * expressions for the data layer. It resolves them against the given unified table\n * spec.\n */\nexport const rewriteLegacyFilters = rewriteFiltersModule.rewriteLegacyFilters;\n"],"mappings":";;;;;;;AAUA,MAAa,gBAAgB,SAA8C,IAAI,OAAO,IAAI;;AAG1F,MAAa,aAAaA;;AAG1B,MAAa,eAAeC;;AAG5B,MAAa,WAAWC;;;;;AAMxB,MAAa,kBAAkBC;;;;;;;;;;AAW/B,MAAa,aAAaC;;;;;;AAO1B,MAAa,uBAAuBC"}

package/dist/p-frame.d.ts

@@ -0,0 +1,48 @@
+import { EvaluateQueryResponse, JoinEntry, PColumnIdAndSpec, PColumnSpec, PObjectId, PTableRecordFilter, PTableSorting, SpecQuery } from "@milaboratories/pl-model-common";
+import { PFrameInternal } from "@milaboratories/pl-model-middle-layer";
+
+//#region src/p-frame.d.ts
+/** A legacy (V4) query. Code used this type before the unified `SpecQuery`. */
+type LegacyQuery = {
+  /** The source join entry. It defines the data sources and the join structure. */src: JoinEntry<PObjectId>; /** Optional record-level filters. The query applies these to its results. */
+  filters?: PTableRecordFilter[]; /** Optional sort specifications. They set the order of the results. */
+  sorting?: PTableSorting[];
+};
+/**
+ * A set of registered column specs, and the spec-plane operations on them.
+ *
+ * Each method uses the specs that this frame holds. No method reads data. The module
+ * surface holds the spec operations that do not need a frame.
+ *
+ * This class holds a WASM resource. Use a `using` declaration to release it. Garbage
+ * collection also releases the resource, but not at a known time.
+ */
+declare class PFrame implements Disposable {
+  #private;
+  constructor(spec: Record<string, PColumnSpec>);
+  /** Deletes columns from a columns specification. */
+  deleteColumns(request: PFrameInternal.DeleteColumnFromColumnsRequest): PFrameInternal.DeleteColumnFromColumnsResponse;
+  /** Returns `null` if this frame has no column with the id `columnId`. */
+  getColumn(columnId: PObjectId): PColumnIdAndSpec | null;
+  /** Lists each column in this frame with its id and its spec. */
+  listColumns(): PColumnIdAndSpec[];
+  /**
+   * Discovers the columns that are compatible with a given axes integration.
+   *
+   * The include filters and the exclude filters apply in order. The exclude filters
+   * remove matches from the include set. Each hit has its own traversal `path`. To
+   * materialize a hit as a `SpecQueryJoinEntry`, give the hit's column id and `path`
+   * to {@link buildQuery}.
+   */
+  discoverColumns(request: PFrameInternal.DiscoverColumnsRequestV2): PFrameInternal.DiscoverColumnsResponse;
+  /** Finds the columns in this frame that match the given filter criteria. */
+  findColumns(request: PFrameInternal.FindColumnsRequest): PFrameInternal.FindColumnsResponse;
+  /** Resolves a query against this frame's specs. Returns a table spec and a data query. */
+  evaluateQuery(request: SpecQuery): EvaluateQueryResponse;
+  /** Upgrades a {@link LegacyQuery} to the current `SpecQuery` format. */
+  rewriteLegacyQuery(request: LegacyQuery): SpecQuery;
+  [Symbol.dispose](): void;
+}
+//#endregion
+export { LegacyQuery, PFrame };
+//# sourceMappingURL=p-frame.d.ts.map

package/dist/p-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"p-frame.d.ts","names":[],"sources":["../src/p-frame.ts"],"mappings":";;;;;KAeY,WAAA;EAAA,iFAEV,GAAA,EAAK,SAAA,CAAU,SAAA;EAEf,OAAA,GAAU,kBAAA,IAFL;EAIL,OAAA,GAAU,aAAA;AAAA;;;;;;;;;;cAYC,MAAA,YAAkB,UAAA;EAAA;cAGjB,IAAA,EAAM,MAAA,SAAe,WAAA;EAHf;EAQlB,aAAA,CACE,OAAA,EAAS,cAAA,CAAe,8BAAA,GACvB,cAAA,CAAe,+BAAA;EAPe;EAYjC,SAAA,CAAU,QAAA,EAAU,SAAA,GAAY,gBAAA;EANrB;EAWX,WAAA,IAAe,gBAAA;EALK;;;;;;;;EAkBpB,eAAA,CACE,OAAA,EAAS,cAAA,CAAe,wBAAA,GACvB,cAAA,CAAe,uBAAA;EAeU;EAV5B,WAAA,CAAY,OAAA,EAAS,cAAA,CAAe,kBAAA,GAAqB,cAAA,CAAe,mBAAA;EAevE;EAVD,aAAA,CAAc,OAAA,EAAS,SAAA,GAAY,qBAAA;EA7CI;EAkDvC,kBAAA,CAAmB,OAAA,EAAS,WAAA,GAAc,SAAA;EAAA,CAKzC,MAAA,CAAO,OAAA;AAAA"}

package/dist/p-frame.js

@@ -0,0 +1,109 @@
+import { spec } from "./generated/pframes_rs_wasip2.js";
+//#region src/p-frame.ts
+/**
+* A set of registered column specs, and the spec-plane operations on them.
+*
+* Each method uses the specs that this frame holds. No method reads data. The module
+* surface holds the spec operations that do not need a frame.
+*
+* This class holds a WASM resource. Use a `using` declaration to release it. Garbage
+* collection also releases the resource, but not at a known time.
+*/
+var PFrame = class {
+	#frame;
+	constructor(spec$1) {
+		this.#frame = spec.Frame.fromJson(JSON.stringify(spec$1));
+	}
+	/** Deletes columns from a columns specification. */
+	deleteColumns(request) {
+		return JSON.parse(spec.Frame.deleteColumns(JSON.stringify(request)));
+	}
+	/** Returns `null` if this frame has no column with the id `columnId`. */
+	getColumn(columnId) {
+		return JSON.parse(this.#frame.getColumn(JSON.stringify(columnId)));
+	}
+	/** Lists each column in this frame with its id and its spec. */
+	listColumns() {
+		const columns = JSON.parse(this.#frame.listColumns());
+		return Object.values(columns);
+	}
+	/**
+	* Discovers the columns that are compatible with a given axes integration.
+	*
+	* The include filters and the exclude filters apply in order. The exclude filters
+	* remove matches from the include set. Each hit has its own traversal `path`. To
+	* materialize a hit as a `SpecQueryJoinEntry`, give the hit's column id and `path`
+	* to {@link buildQuery}.
+	*/
+	discoverColumns(request) {
+		return JSON.parse(this.#frame.discoverColumns(JSON.stringify(request)));
+	}
+	/** Finds the columns in this frame that match the given filter criteria. */
+	findColumns(request) {
+		return JSON.parse(this.#frame.findColumns(JSON.stringify(request)));
+	}
+	/** Resolves a query against this frame's specs. Returns a table spec and a data query. */
+	evaluateQuery(request) {
+		return JSON.parse(this.#frame.evaluateQuery(JSON.stringify(request)));
+	}
+	/** Upgrades a {@link LegacyQuery} to the current `SpecQuery` format. */
+	rewriteLegacyQuery(request) {
+		const src = joinEntryToInternal(request.src);
+		return JSON.parse(this.#frame.rewriteLegacyQuery(JSON.stringify({
+			...request,
+			src
+		})));
+	}
+	[Symbol.dispose]() {
+		this.#frame[Symbol.dispose]();
+	}
+};
+function joinEntryToInternal(entry) {
+	const type = entry.type;
+	switch (type) {
+		case "column": return {
+			type: "column",
+			columnId: entry.column
+		};
+		case "slicedColumn": return {
+			type: "slicedColumn",
+			columnId: entry.column,
+			newId: entry.newId,
+			axisFilters: entry.axisFilters
+		};
+		case "artificialColumn": return {
+			type: "artificialColumn",
+			columnId: entry.column,
+			newId: entry.newId,
+			axesIndices: entry.axesIndices
+		};
+		case "inlineColumn": return {
+			type: "inlineColumn",
+			newId: entry.column.id,
+			spec: entry.column.spec,
+			dataInfo: {
+				type: "Json",
+				keyLength: entry.column.spec.axesSpec.length,
+				data: entry.column.data.reduce((acc, row) => {
+					acc[JSON.stringify(row.key)] = row.val;
+					return acc;
+				}, {})
+			}
+		};
+		case "inner":
+		case "full": return {
+			type: entry.type,
+			entries: entry.entries.map((col) => joinEntryToInternal(col))
+		};
+		case "outer": return {
+			type: "outer",
+			primary: joinEntryToInternal(entry.primary),
+			secondary: entry.secondary.map((col) => joinEntryToInternal(col))
+		};
+		default: throw new Error(`unsupported PFrame join entry type: ${type}`);
+	}
+}
+//#endregion
+export { PFrame };
+
+//# sourceMappingURL=p-frame.js.map

package/dist/p-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"p-frame.js","names":["#frame","bindings","spec"],"sources":["../src/p-frame.ts"],"sourcesContent":["import type {\n  EvaluateQueryResponse,\n  JoinEntry,\n  PColumnIdAndSpec,\n  PColumnSpec,\n  PColumnValue,\n  PObjectId,\n  PTableRecordFilter,\n  PTableSorting,\n  SpecQuery,\n} from \"@milaboratories/pl-model-common\";\nimport type { PFrameInternal } from \"@milaboratories/pl-model-middle-layer\";\nimport { spec as bindings } from \"./generated/pframes_rs_wasip2.js\";\n\n/** A legacy (V4) query. Code used this type before the unified `SpecQuery`. */\nexport type LegacyQuery = {\n  /** The source join entry. It defines the data sources and the join structure. */\n  src: JoinEntry<PObjectId>;\n  /** Optional record-level filters. The query applies these to its results. */\n  filters?: PTableRecordFilter[];\n  /** Optional sort specifications. They set the order of the results. */\n  sorting?: PTableSorting[];\n};\n\n/**\n * A set of registered column specs, and the spec-plane operations on them.\n *\n * Each method uses the specs that this frame holds. No method reads data. The module\n * surface holds the spec operations that do not need a frame.\n *\n * This class holds a WASM resource. Use a `using` declaration to release it. Garbage\n * collection also releases the resource, but not at a known time.\n */\nexport class PFrame implements Disposable {\n  #frame: bindings.Frame;\n\n  constructor(spec: Record<string, PColumnSpec>) {\n    this.#frame = bindings.Frame.fromJson(JSON.stringify(spec));\n  }\n\n  /** Deletes columns from a columns specification. */\n  deleteColumns(\n    request: PFrameInternal.DeleteColumnFromColumnsRequest,\n  ): PFrameInternal.DeleteColumnFromColumnsResponse {\n    return JSON.parse(bindings.Frame.deleteColumns(JSON.stringify(request)));\n  }\n\n  /** Returns `null` if this frame has no column with the id `columnId`. */\n  getColumn(columnId: PObjectId): PColumnIdAndSpec | null {\n    return JSON.parse(this.#frame.getColumn(JSON.stringify(columnId)));\n  }\n\n  /** Lists each column in this frame with its id and its spec. */\n  listColumns(): PColumnIdAndSpec[] {\n    const columns = JSON.parse(this.#frame.listColumns()) as Record<string, PColumnIdAndSpec>;\n    return Object.values(columns);\n  }\n\n  /**\n   * Discovers the columns that are compatible with a given axes integration.\n   *\n   * The include filters and the exclude filters apply in order. The exclude filters\n   * remove matches from the include set. Each hit has its own traversal `path`. To\n   * materialize a hit as a `SpecQueryJoinEntry`, give the hit's column id and `path`\n   * to {@link buildQuery}.\n   */\n  discoverColumns(\n    request: PFrameInternal.DiscoverColumnsRequestV2,\n  ): PFrameInternal.DiscoverColumnsResponse {\n    return JSON.parse(this.#frame.discoverColumns(JSON.stringify(request)));\n  }\n\n  /** Finds the columns in this frame that match the given filter criteria. */\n  findColumns(request: PFrameInternal.FindColumnsRequest): PFrameInternal.FindColumnsResponse {\n    return JSON.parse(this.#frame.findColumns(JSON.stringify(request)));\n  }\n\n  /** Resolves a query against this frame's specs. Returns a table spec and a data query. */\n  evaluateQuery(request: SpecQuery): EvaluateQueryResponse {\n    return JSON.parse(this.#frame.evaluateQuery(JSON.stringify(request)));\n  }\n\n  /** Upgrades a {@link LegacyQuery} to the current `SpecQuery` format. */\n  rewriteLegacyQuery(request: LegacyQuery): SpecQuery {\n    const src = joinEntryToInternal(request.src);\n    return JSON.parse(this.#frame.rewriteLegacyQuery(JSON.stringify({ ...request, src })));\n  }\n\n  [Symbol.dispose](): void {\n    this.#frame[Symbol.dispose]();\n  }\n}\n\nfunction joinEntryToInternal(entry: JoinEntry<PObjectId>): PFrameInternal.JoinEntryV4 {\n  const type = entry.type;\n  switch (type) {\n    case \"column\":\n      return {\n        type: \"column\",\n        columnId: entry.column,\n      };\n    case \"slicedColumn\":\n      return {\n        type: \"slicedColumn\",\n        columnId: entry.column,\n        newId: entry.newId,\n        axisFilters: entry.axisFilters,\n      };\n    case \"artificialColumn\":\n      return {\n        type: \"artificialColumn\",\n        columnId: entry.column,\n        newId: entry.newId,\n        axesIndices: entry.axesIndices,\n      };\n    case \"inlineColumn\":\n      return {\n        type: \"inlineColumn\",\n        newId: entry.column.id,\n        spec: entry.column.spec,\n        dataInfo: {\n          type: \"Json\",\n          keyLength: entry.column.spec.axesSpec.length,\n          data: entry.column.data.reduce(\n            (acc, row) => {\n              acc[JSON.stringify(row.key)] = row.val;\n              return acc;\n            },\n            {} as Record<string, PColumnValue>,\n          ),\n        },\n      };\n    case \"inner\":\n    case \"full\":\n      return {\n        type: entry.type,\n        entries: entry.entries.map((col) => joinEntryToInternal(col)),\n      };\n    case \"outer\":\n      return {\n        type: \"outer\",\n        primary: joinEntryToInternal(entry.primary),\n        secondary: entry.secondary.map((col) => joinEntryToInternal(col)),\n      };\n    default:\n      throw new Error(`unsupported PFrame join entry type: ${type satisfies never}`);\n  }\n}\n"],"mappings":";;;;;;;;;;;AAiCA,IAAa,SAAb,MAA0C;CACxC;CAEA,YAAY,QAAmC;EAC7C,KAAKA,SAASC,KAAS,MAAM,SAAS,KAAK,UAAUC,MAAI,CAAC;CAC5D;;CAGA,cACE,SACgD;EAChD,OAAO,KAAK,MAAMD,KAAS,MAAM,cAAc,KAAK,UAAU,OAAO,CAAC,CAAC;CACzE;;CAGA,UAAU,UAA8C;EACtD,OAAO,KAAK,MAAM,KAAKD,OAAO,UAAU,KAAK,UAAU,QAAQ,CAAC,CAAC;CACnE;;CAGA,cAAkC;EAChC,MAAM,UAAU,KAAK,MAAM,KAAKA,OAAO,YAAY,CAAC;EACpD,OAAO,OAAO,OAAO,OAAO;CAC9B;;;;;;;;;CAUA,gBACE,SACwC;EACxC,OAAO,KAAK,MAAM,KAAKA,OAAO,gBAAgB,KAAK,UAAU,OAAO,CAAC,CAAC;CACxE;;CAGA,YAAY,SAAgF;EAC1F,OAAO,KAAK,MAAM,KAAKA,OAAO,YAAY,KAAK,UAAU,OAAO,CAAC,CAAC;CACpE;;CAGA,cAAc,SAA2C;EACvD,OAAO,KAAK,MAAM,KAAKA,OAAO,cAAc,KAAK,UAAU,OAAO,CAAC,CAAC;CACtE;;CAGA,mBAAmB,SAAiC;EAClD,MAAM,MAAM,oBAAoB,QAAQ,GAAG;EAC3C,OAAO,KAAK,MAAM,KAAKA,OAAO,mBAAmB,KAAK,UAAU;GAAE,GAAG;GAAS;EAAI,CAAC,CAAC,CAAC;CACvF;CAEA,CAAC,OAAO,WAAiB;EACvB,KAAKA,OAAO,OAAO,QAAQ,CAAC;CAC9B;AACF;AAEA,SAAS,oBAAoB,OAAyD;CACpF,MAAM,OAAO,MAAM;CACnB,QAAQ,MAAR;EACE,KAAK,UACH,OAAO;GACL,MAAM;GACN,UAAU,MAAM;EAClB;EACF,KAAK,gBACH,OAAO;GACL,MAAM;GACN,UAAU,MAAM;GAChB,OAAO,MAAM;GACb,aAAa,MAAM;EACrB;EACF,KAAK,oBACH,OAAO;GACL,MAAM;GACN,UAAU,MAAM;GAChB,OAAO,MAAM;GACb,aAAa,MAAM;EACrB;EACF,KAAK,gBACH,OAAO;GACL,MAAM;GACN,OAAO,MAAM,OAAO;GACpB,MAAM,MAAM,OAAO;GACnB,UAAU;IACR,MAAM;IACN,WAAW,MAAM,OAAO,KAAK,SAAS;IACtC,MAAM,MAAM,OAAO,KAAK,QACrB,KAAK,QAAQ;KACZ,IAAI,KAAK,UAAU,IAAI,GAAG,KAAK,IAAI;KACnC,OAAO;IACT,GACA,CAAC,CACH;GACF;EACF;EACF,KAAK;EACL,KAAK,QACH,OAAO;GACL,MAAM,MAAM;GACZ,SAAS,MAAM,QAAQ,KAAK,QAAQ,oBAAoB,GAAG,CAAC;EAC9D;EACF,KAAK,SACH,OAAO;GACL,MAAM;GACN,SAAS,oBAAoB,MAAM,OAAO;GAC1C,WAAW,MAAM,UAAU,KAAK,QAAQ,oBAAoB,GAAG,CAAC;EAClE;EACF,SACE,MAAM,IAAI,MAAM,uCAAuC,MAAsB;CACjF;AACF"}

package/dist/rewrite-filters.d.ts

@@ -0,0 +1,20 @@
+import { DataQueryBooleanExpression, PTableColumnSpec, PTableRecordFilter } from "@milaboratories/pl-model-common";
+
+//#region src/rewrite-filters.d.ts
+/**
+ * Upgrades the selector-based legacy record filters into index-based boolean
+ * expressions for the data layer. It resolves them against the given unified
+ * table spec, which holds the axes first and then the columns.
+ *
+ * The operation is stateless, because a filter does not change the spec of a
+ * table. Therefore the result is valid for `getUniqueValues`, which works on
+ * the single-column table of the source column. The result is also valid when
+ * you compose a `filter` over a `table` query node.
+ */
+declare function rewriteLegacyFilters(request: {
+  tableSpec: PTableColumnSpec[];
+  filters: PTableRecordFilter[];
+}): DataQueryBooleanExpression[];
+//#endregion
+export { rewriteLegacyFilters };
+//# sourceMappingURL=rewrite-filters.d.ts.map

package/dist/rewrite-filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewrite-filters.d.ts","names":[],"sources":["../src/rewrite-filters.ts"],"mappings":";;;;;AAiBA;;;;;;;;iBAAgB,oBAAA,CAAqB,OAAA;EACnC,SAAA,EAAW,gBAAA;EACX,OAAA,EAAS,kBAAA;AAAA,IACP,0BAAA"}

package/dist/rewrite-filters.js

@@ -0,0 +1,19 @@
+import { spec } from "./generated/pframes_rs_wasip2.js";
+//#region src/rewrite-filters.ts
+/**
+* Upgrades the selector-based legacy record filters into index-based boolean
+* expressions for the data layer. It resolves them against the given unified
+* table spec, which holds the axes first and then the columns.
+*
+* The operation is stateless, because a filter does not change the spec of a
+* table. Therefore the result is valid for `getUniqueValues`, which works on
+* the single-column table of the source column. The result is also valid when
+* you compose a `filter` over a `table` query node.
+*/
+function rewriteLegacyFilters(request) {
+	return JSON.parse(spec.Frame.rewriteLegacyFilters(JSON.stringify(request)));
+}
+//#endregion
+export { rewriteLegacyFilters };
+
+//# sourceMappingURL=rewrite-filters.js.map

package/dist/rewrite-filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewrite-filters.js","names":["bindings"],"sources":["../src/rewrite-filters.ts"],"sourcesContent":["import type {\n  DataQueryBooleanExpression,\n  PTableColumnSpec,\n  PTableRecordFilter,\n} from \"@milaboratories/pl-model-common\";\nimport { spec as bindings } from \"./generated/pframes_rs_wasip2.js\";\n\n/**\n * Upgrades the selector-based legacy record filters into index-based boolean\n * expressions for the data layer. It resolves them against the given unified\n * table spec, which holds the axes first and then the columns.\n *\n * The operation is stateless, because a filter does not change the spec of a\n * table. Therefore the result is valid for `getUniqueValues`, which works on\n * the single-column table of the source column. The result is also valid when\n * you compose a `filter` over a `table` query node.\n */\nexport function rewriteLegacyFilters(request: {\n  tableSpec: PTableColumnSpec[];\n  filters: PTableRecordFilter[];\n}): DataQueryBooleanExpression[] {\n  return JSON.parse(bindings.Frame.rewriteLegacyFilters(JSON.stringify(request)));\n}\n"],"mappings":";;;;;;;;;;;;AAiBA,SAAgB,qBAAqB,SAGJ;CAC/B,OAAO,KAAK,MAAMA,KAAS,MAAM,qBAAqB,KAAK,UAAU,OAAO,CAAC,CAAC;AAChF"}

package/dist/table.d.ts

@@ -0,0 +1,7 @@
+import { PTableColumnId, PTableColumnSpec } from "@milaboratories/pl-model-common";
+
+//#region src/table.d.ts
+declare function findColumn(tableSpec: PTableColumnSpec[], selector: PTableColumnId): number;
+//#endregion
+export { findColumn };
+//# sourceMappingURL=table.d.ts.map

package/dist/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","names":[],"sources":["../src/table.ts"],"mappings":";;;iBAGgB,UAAA,CAAW,SAAA,EAAW,gBAAA,IAAoB,QAAA,EAAU,cAAc"}

package/dist/table.js

@@ -0,0 +1,22 @@
+import { spec } from "./generated/pframes_rs_wasip2.js";
+import _usingCtx from "./_virtual/_@oxc-project_runtime@0.137.0/helpers/esm/usingCtx.js";
+//#region src/table.ts
+function findColumn(tableSpec, selector) {
+	try {
+		var _usingCtx$1 = _usingCtx();
+		const table = _usingCtx$1.u(spec.Table.fromJson(JSON.stringify(tableSpec)));
+		try {
+			return JSON.parse(table.findColumn(JSON.stringify(selector)));
+		} catch {
+			return -1;
+		}
+	} catch (_) {
+		_usingCtx$1.e = _;
+	} finally {
+		_usingCtx$1.d();
+	}
+}
+//#endregion
+export { findColumn };
+
+//# sourceMappingURL=table.js.map

package/dist/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","names":["bindings"],"sources":["../src/table.ts"],"sourcesContent":["import type { PTableColumnId, PTableColumnSpec } from \"@milaboratories/pl-model-common\";\nimport { spec as bindings } from \"./generated/pframes_rs_wasip2.js\";\n\nexport function findColumn(tableSpec: PTableColumnSpec[], selector: PTableColumnId): number {\n  using table = bindings.Table.fromJson(JSON.stringify(tableSpec));\n  try {\n    return JSON.parse(table.findColumn(JSON.stringify(selector)));\n  } catch {\n    return -1;\n  }\n}\n"],"mappings":";;;AAGA,SAAgB,WAAW,WAA+B,UAAkC;;;EAC1F,MAAM,QAAA,YAAA,EAAQA,KAAS,MAAM,SAAS,KAAK,UAAU,SAAS,CAAC,CAAA;EAC/D,IAAI;GACF,OAAO,KAAK,MAAM,MAAM,WAAW,KAAK,UAAU,QAAQ,CAAC,CAAC;EAC9D,QAAQ;GACN,OAAO;EACT;;;;;;AACF"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@milaboratories/pf-spec",
+  "version": "1.0.0",
+  "description": "Spec-plane PFrame operations: bindings to the pframes WASM component",
+  "keywords": [],
+  "license": "UNLICENSED",
+  "files": [
+    "./dist/**/*",
+    "./src/*.ts"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@milaboratories/pl-model-common": "1.47.3",
+    "@milaboratories/pl-model-middle-layer": "1.31.0"
+  },
+  "devDependencies": {
+    "@bytecodealliance/jco-transpile": "^0.6.3",
+    "@bytecodealliance/preview2-shim": "^0.20.1",
+    "@milaboratories/pframes-rs-wasip2": "1.1.56",
+    "@types/node": "~24.5.2",
+    "@vitest/coverage-istanbul": "^4.1.3",
+    "rollup-plugin-copy": "^3.5.0",
+    "typescript": "~5.9.3",
+    "vitest": "^4.1.3",
+    "@milaboratories/build-configs": "2.0.0",
+    "@milaboratories/ts-configs": "1.4.0",
+    "@milaboratories/ts-builder": "1.6.2"
+  },
+  "peerDependencies": {
+    "@bytecodealliance/preview2-shim": "^0.20.1"
+  },
+  "scripts": {
+    "transpile": "node --conditions=wasm scripts/transpile.ts",
+    "build": "ts-builder build --target node --build-config build.config.js",
+    "watch": "ts-builder build --target node --build-config build.config.js --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/axes.test.ts

@@ -0,0 +1,24 @@
+import { expect, test } from "vitest";
+import { collapse, expand, find } from "./axes.ts";
+
+const axesSpec = [{ type: "Int" as const, name: "a1" }];
+
+test("expand", () => {
+  const ids = expand(axesSpec);
+  expect(ids).toEqual([{ name: "a1", type: "Int" }]);
+});
+
+test("collapse", () => {
+  const spec = collapse([{ name: "a1", type: "Int" }]);
+  expect(spec).toEqual(axesSpec);
+});
+
+test("find - match", () => {
+  const index = find(axesSpec, { name: "a1" });
+  expect(index).toBe(0);
+});
+
+test("find - no match", () => {
+  const index = find(axesSpec, { name: "nonexistent" });
+  expect(index).toBe(-1);
+});

package/src/axes.ts

@@ -0,0 +1,20 @@
+import type { AxesId, AxesSpec, SingleAxisSelector } from "@milaboratories/pl-model-common";
+import { spec as bindings } from "./generated/pframes_rs_wasip2.js";
+
+export function expand(spec: AxesSpec): AxesId {
+  using axes = bindings.Axes.fromJson(JSON.stringify(spec));
+  return JSON.parse(axes.expand());
+}
+
+export function collapse(ids: AxesId): AxesSpec {
+  return JSON.parse(bindings.Axes.collapse(JSON.stringify(ids)));
+}
+
+export function find(spec: AxesSpec, selector: SingleAxisSelector): number {
+  using axes = bindings.Axes.fromJson(JSON.stringify(spec));
+  try {
+    return JSON.parse(axes.find(JSON.stringify(selector)));
+  } catch {
+    return -1;
+  }
+}

package/src/build-query.ts

@@ -0,0 +1,6 @@
+import type { BuildQueryInput, SpecQueryJoinEntry } from "@milaboratories/pl-model-common";
+import { spec as bindings } from "./generated/pframes_rs_wasip2.js";
+
+export function build(input: BuildQueryInput): SpecQueryJoinEntry {
+  return JSON.parse(bindings.Frame.buildQuery(JSON.stringify(input)));
+}

package/src/index.ts

@@ -0,0 +1,44 @@
+import type { PColumnSpec } from "@milaboratories/pl-model-common";
+import * as axes from "./axes.ts";
+import * as buildQueryModule from "./build-query.ts";
+import { PFrame } from "./p-frame.ts";
+import * as rewriteFiltersModule from "./rewrite-filters.ts";
+import * as table from "./table.ts";
+
+export { PFrame, type LegacyQuery } from "./p-frame";
+
+/** Creates a {@link PFrame} from a map of column ids to column specifications. */
+export const createPFrame = (spec: Record<string, PColumnSpec>): PFrame => new PFrame(spec);
+
+/** Expands an `AxesSpec` into `AxesId`s and resolves the parent information. */
+export const expandAxes = axes.expand;
+
+/** This operation is the inverse of {@link expandAxes}. */
+export const collapseAxes = axes.collapse;
+
+/** Returns the index of the axis that matches `selector`, or -1 if no axis matches. */
+export const findAxis = axes.find;
+
+/**
+ * Returns the index of the table column that matches `selector`. It returns -1 if no
+ * column matches. A table spec indexes the axes first and then the columns.
+ */
+export const findTableColumn = table.findColumn;
+
+/**
+ * Assembles a `SpecQueryJoinEntry` from a terminal column and an ordered path of
+ * steps. The steps are linker hops and filter joins.
+ *
+ * The operation is a right fold over `path`, and it starts at the column. Each
+ * `linker` step wraps the current subquery as a `linkerJoin`. Each `filter` step
+ * wraps the current subquery as an `innerJoin` with the filter column.
+ * `qualifications` annotate only the outermost entry.
+ */
+export const buildQuery = buildQueryModule.build;
+
+/**
+ * Upgrades the selector-based legacy record filters into index-based boolean
+ * expressions for the data layer. It resolves them against the given unified table
+ * spec.
+ */
+export const rewriteLegacyFilters = rewriteFiltersModule.rewriteLegacyFilters;