@platforma-sdk/model 1.58.3 → 1.58.9

package/dist/pframe_utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/pframe_utils/index.ts"],"sourcesContent":["import { flatten, uniq } from \"es-toolkit\";\n\nimport type {\n  AxisSpec,\n  CalculateTableDataRequest,\n  PColumnSpec,\n  PFrameHandle,\n  PTableVector,\n  UniqueValuesRequest,\n  AxisId,\n  CanonicalizedJson,\n  FindColumnsRequest,\n  FindColumnsResponse,\n  FullPTableColumnData,\n  PColumnIdAndSpec,\n  PObjectId,\n  PTableRecordSingleValueFilterV2,\n  ValueType,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  pTableValue,\n  Annotation,\n  canonicalizeAxisId,\n  getAxisId,\n  readAnnotation,\n  PColumnName,\n} from \"@milaboratories/pl-model-common\";\n\nexport * from \"./columns\";\n\n// Types\ntype PValue = string | number | null;\n\ntype SuggestionResponse = {\n  values: {\n    value: string;\n    label: string;\n  }[];\n  overflow: boolean;\n};\n\ntype SingleColumnData = {\n  axesData: Record<string, PValue[]>;\n  data: PValue[];\n};\n\ntype UniqueValuesResponse = {\n  values: string[];\n  overflow: boolean;\n};\n\ntype GetUniqueSourceValuesParams = {\n  columnId: PObjectId;\n  axisIdx?: number;\n  limit?: number;\n  searchQuery?: string;\n  searchQueryValue?: string;\n};\n\ntype GetAxisUniqueValuesParams = {\n  axisId: AxisId;\n  parentColumnIds: PObjectId[];\n  limit?: number;\n  filters?: PTableRecordSingleValueFilterV2[];\n};\n\ntype GetColumnsFullParams = {\n  selectedSources: PObjectId[];\n  strictlyCompatible: boolean;\n  types?: ValueType[];\n  names?: string[];\n  annotations?: FindColumnsRequest[\"columnFilter\"][\"annotationValue\"];\n  annotationsNotEmpty?: string[];\n};\n\n// Constants\nconst UNIQUE_VALUES_LIMIT = 1000000;\n\n// Helper functions\nconst sortValuesPredicate = (a: { label: string }, b: { label: string }) =>\n  a.label.localeCompare(b.label, \"en\", { numeric: true });\n\nfunction convertColumnData(\n  type: ValueType,\n  response: PTableVector,\n  absentValue: number | null = null,\n): PValue[] {\n  if (type === \"String\") {\n    return response.data as PValue[];\n  }\n  const res: PValue[] = new Array(response.data.length);\n  for (let i = 0; i < response.data.length; i++) {\n    res[i] = pTableValue(response, i, { absent: absentValue, na: null }) as PValue;\n  }\n  return res;\n}\n\nfunction createSearchFilter(\n  columnId: PObjectId,\n  substring: string,\n): PTableRecordSingleValueFilterV2 {\n  return {\n    type: \"bySingleColumnV2\",\n    column: {\n      type: \"column\",\n      id: columnId,\n    },\n    predicate: {\n      operator: \"StringIContains\",\n      substring,\n    },\n  };\n}\n\nfunction createAxisSearchFilter(\n  axisSpec: AxisSpec,\n  substring: string,\n): PTableRecordSingleValueFilterV2 {\n  return {\n    type: \"bySingleColumnV2\",\n    column: {\n      type: \"axis\",\n      id: {\n        type: axisSpec.type,\n        name: axisSpec.name,\n      },\n    },\n    predicate: {\n      operator: \"StringIContains\",\n      substring,\n    },\n  };\n}\n\nfunction mapValuesToSuggestions(values: string[]): { value: string; label: string }[] {\n  return values.map((v) => ({ value: String(v), label: String(v) })).sort(sortValuesPredicate);\n}\n\nfunction getPFrameDriver() {\n  if (typeof platforma === \"undefined\") {\n    throw new Error(\"Platforma instance is not available\");\n  }\n  if (typeof platforma.pFrameDriver === \"undefined\") {\n    throw new Error(\"PFrame driver is not available in the current Platforma instance\");\n  }\n  return platforma.pFrameDriver;\n}\n\n// Core functions\nexport async function getColumnSpecById(\n  handle: PFrameHandle,\n  id: PObjectId,\n): Promise<PColumnSpec | null> {\n  try {\n    const response = await getPFrameDriver().getColumnSpec(handle, id);\n    return response ?? null;\n  } catch (err) {\n    console.error(\"PFrame: get single column error\", err);\n    return null;\n  }\n}\n\nexport async function getSingleColumnData(\n  handle: PFrameHandle,\n  id: PObjectId,\n  filters: PTableRecordSingleValueFilterV2[] = [],\n): Promise<SingleColumnData> {\n  try {\n    const response: FullPTableColumnData[] = await getPFrameDriver().calculateTableData(handle, {\n      src: {\n        type: \"column\",\n        column: id,\n      },\n      filters,\n      sorting: [],\n    } as CalculateTableDataRequest<PObjectId>);\n\n    const axes = response.filter((item) => item.spec.type === \"axis\");\n    const columns = response.filter((item) => item.spec.type === \"column\");\n\n    return {\n      axesData: axes.reduce((res: Record<string, PValue[]>, item) => {\n        const id = getAxisId(item.spec.spec as AxisSpec);\n        res[canonicalizeAxisId(id)] = convertColumnData(id.type, item.data);\n        return res;\n      }, {}),\n      data: columns.length ? convertColumnData(columns[0].data.type, columns[0].data) : [],\n    };\n  } catch (err) {\n    console.error(\"PFrame: calculateTableData error\");\n    throw err;\n  }\n}\n\nexport async function getColumnUniqueValues(\n  handle: PFrameHandle,\n  id: PObjectId,\n  limit = UNIQUE_VALUES_LIMIT,\n  filters: PTableRecordSingleValueFilterV2[] = [],\n): Promise<UniqueValuesResponse> {\n  const request: UniqueValuesRequest = {\n    columnId: id,\n    filters,\n    limit,\n  };\n\n  try {\n    const response = await getPFrameDriver().getUniqueValues(handle, request);\n    if (response.overflow) {\n      console.warn(`More than ${limit} values for ${id} column`);\n    }\n    return {\n      values: Array.from(response.values.data as ArrayLike<unknown>).map(String),\n      overflow: response.overflow,\n    };\n  } catch (err) {\n    console.error(\"PFrame: getUniqueValues for column error\");\n    throw err;\n  }\n}\n\nexport async function getAxisUniqueValues(\n  handle: PFrameHandle,\n  params: GetAxisUniqueValuesParams,\n): Promise<UniqueValuesResponse> {\n  const { axisId, parentColumnIds, limit = UNIQUE_VALUES_LIMIT, filters = [] } = params;\n  const strAxisId = canonicalizeAxisId(axisId);\n\n  const parentsSpecs = (await Promise.all(parentColumnIds.map((p) => getColumnSpecById(handle, p))))\n    .flatMap((spec, i): [PObjectId, PColumnSpec][] =>\n      spec != null && spec.kind === \"PColumn\" ? [[parentColumnIds[i], spec]] : [],\n    )\n    .filter(([_, spec]) =>\n      spec.axesSpec.some((axisSpec) => canonicalizeAxisId(getAxisId(axisSpec)) === strAxisId),\n    );\n\n  if (parentsSpecs.length === 0) {\n    console.warn(\"Axis unique values requested without parent columns\");\n    return { values: [], overflow: false };\n  }\n\n  try {\n    const responses = await Promise.all(\n      parentsSpecs.map(([id]) =>\n        getPFrameDriver().getUniqueValues(handle, {\n          columnId: id,\n          axis: axisId,\n          filters,\n          limit,\n        }),\n      ),\n    );\n\n    const overflow = responses.some((r) => r.overflow);\n    return {\n      values: uniq(\n        flatten(responses.map((r) => Array.from(r.values.data as ArrayLike<unknown>).map(String))),\n      ),\n      overflow,\n    };\n  } catch (err) {\n    console.error(\"PFrame: getUniqueValues for axis error\", err);\n    return { values: [], overflow: false };\n  }\n}\n\nexport async function getRequestColumnsFromSelectedSources(\n  handle: PFrameHandle,\n  sources: PObjectId[],\n): Promise<AxisId[]> {\n  const result: AxisId[] = [];\n  for (const item of sources) {\n    const spec = await getColumnSpecById(handle, item);\n    if (spec?.kind === \"PColumn\") {\n      result.push(...spec.axesSpec.map((spec) => getAxisId(spec)));\n    }\n  }\n  return result;\n}\n\nexport async function getColumnsFull(\n  handle: PFrameHandle,\n  params: GetColumnsFullParams,\n): Promise<PColumnIdAndSpec[]> {\n  const { selectedSources, strictlyCompatible, types, names, annotations, annotationsNotEmpty } =\n    params;\n\n  try {\n    const request: FindColumnsRequest = {\n      columnFilter: {\n        type: types,\n        name: names,\n        annotationValue: annotations,\n        annotationPattern: annotationsNotEmpty?.reduce(\n          (res, v) => {\n            res[v] = \".+\";\n            return res;\n          },\n          {} as Record<string, string>,\n        ),\n      },\n      compatibleWith: await getRequestColumnsFromSelectedSources(handle, selectedSources),\n      strictlyCompatible,\n    };\n\n    const response: FindColumnsResponse = await getPFrameDriver().findColumns(handle, request);\n    return response.hits;\n  } catch (err) {\n    console.error(\"PFrame: findColumns error\");\n    throw err;\n  }\n}\n\nexport async function getColumnOrAxisValueLabelsId(\n  handle: PFrameHandle,\n  strAxisId: CanonicalizedJson<AxisId>,\n): Promise<PObjectId | undefined> {\n  const labelColumns = await getColumnsFull(handle, {\n    selectedSources: [],\n    strictlyCompatible: false,\n    names: [PColumnName.Label],\n  });\n\n  const labelColumn = labelColumns.find(({ spec }) => {\n    return spec && spec.axesSpec.length === 1 && canonicalizeAxisId(spec.axesSpec[0]) === strAxisId;\n  });\n\n  return labelColumn?.columnId;\n}\n\nfunction getDiscreteValuesFromAnnotation(columnSpec: PColumnSpec): undefined | SuggestionResponse {\n  const discreteValuesStr = readAnnotation(columnSpec, Annotation.DiscreteValues);\n  if (!discreteValuesStr) {\n    return undefined;\n  }\n\n  try {\n    const discreteValues: string[] = (JSON.parse(discreteValuesStr) as (string | number)[]).map(\n      (v) => String(v),\n    );\n    const values = discreteValues.map((v) => ({ value: v, label: v })).sort(sortValuesPredicate);\n    return { values, overflow: false };\n  } catch {\n    console.error(`Parsing error: discrete values annotation ${discreteValuesStr}`);\n    return undefined;\n  }\n}\n\nasync function getAxisValuesWithLabels(\n  handle: PFrameHandle,\n  params: {\n    columnId: PObjectId;\n    axisSpec: AxisSpec;\n    labelsColumnId: PObjectId | undefined;\n    limit?: number;\n    searchQuery?: string;\n    searchQueryValue?: string;\n  },\n): Promise<SuggestionResponse> {\n  const { columnId, axisSpec, labelsColumnId, limit, searchQuery, searchQueryValue } = params;\n  const strAxisId = canonicalizeAxisId(getAxisId(axisSpec));\n\n  let filters: PTableRecordSingleValueFilterV2[] = [];\n\n  if (labelsColumnId) {\n    if (searchQuery) {\n      filters = [createSearchFilter(labelsColumnId, searchQuery)];\n    }\n    if (searchQueryValue) {\n      filters = [createAxisSearchFilter(axisSpec, searchQueryValue)];\n    }\n\n    const { data: dataValues, axesData } = await getSingleColumnData(\n      handle,\n      labelsColumnId,\n      filters,\n    );\n    const axisKeys = axesData[strAxisId];\n    const values: { value: string; label: string }[] = [];\n\n    for (let i = 0; i < Math.min(axisKeys.length, limit ?? axisKeys.length); i++) {\n      values.push({ value: String(axisKeys[i]), label: String(dataValues[i]) });\n    }\n\n    values.sort(sortValuesPredicate);\n    return { values, overflow: !(limit === undefined || axisKeys.length < limit) };\n  } else {\n    const searchInLabelsOrValue = searchQuery ?? searchQueryValue;\n    if (searchInLabelsOrValue) {\n      filters = [createAxisSearchFilter(axisSpec, searchInLabelsOrValue)];\n    }\n\n    const response = await getAxisUniqueValues(handle, {\n      axisId: getAxisId(axisSpec),\n      parentColumnIds: [columnId],\n      limit,\n      filters,\n    });\n\n    const values = mapValuesToSuggestions(response.values);\n    return { values, overflow: response.overflow };\n  }\n}\n\nasync function getColumnValuesWithLabels(\n  handle: PFrameHandle,\n  params: {\n    columnId: PObjectId;\n    limit?: number;\n    searchQuery?: string;\n    searchQueryValue?: string;\n  },\n): Promise<SuggestionResponse> {\n  const { columnId, limit, searchQuery, searchQueryValue } = params;\n  const searchInLabelsOrValue = searchQuery ?? searchQueryValue;\n\n  const filters: PTableRecordSingleValueFilterV2[] = searchInLabelsOrValue\n    ? [createSearchFilter(columnId, searchInLabelsOrValue)]\n    : [];\n\n  const response = await getColumnUniqueValues(handle, columnId, limit, filters);\n  const values = mapValuesToSuggestions(response.values);\n  return { values, overflow: response.overflow };\n}\n\nexport async function getUniqueSourceValuesWithLabels(\n  handle: PFrameHandle,\n  params: GetUniqueSourceValuesParams,\n): Promise<SuggestionResponse> {\n  const { columnId, axisIdx, limit, searchQuery, searchQueryValue } = params;\n\n  const selectedSourceSpec = await getColumnSpecById(handle, columnId);\n  if (selectedSourceSpec == null || selectedSourceSpec.kind !== \"PColumn\") {\n    return { values: [], overflow: false };\n  }\n\n  // Try to get discrete values from annotation\n  const discreteValues = getDiscreteValuesFromAnnotation(selectedSourceSpec);\n  if (discreteValues != null) {\n    return discreteValues;\n  }\n\n  // Handle axis values\n  if (axisIdx != null) {\n    const axisSpec = selectedSourceSpec.axesSpec[axisIdx];\n    const strAxisId = canonicalizeAxisId(getAxisId(axisSpec));\n    const labelsColumnId = await getColumnOrAxisValueLabelsId(handle, strAxisId);\n\n    return getAxisValuesWithLabels(handle, {\n      columnId,\n      axisSpec,\n      labelsColumnId,\n      limit,\n      searchQuery,\n      searchQueryValue,\n    });\n  }\n\n  // Handle column values\n  return getColumnValuesWithLabels(handle, {\n    columnId,\n    limit,\n    searchQuery,\n    searchQueryValue,\n  });\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/pframe_utils/index.ts"],"sourcesContent":["import { flatten, uniq } from \"es-toolkit\";\n\nimport type {\n  AxisSpec,\n  CalculateTableDataRequest,\n  PColumnSpec,\n  PFrameHandle,\n  PTableVector,\n  UniqueValuesRequest,\n  AxisId,\n  CanonicalizedJson,\n  FindColumnsRequest,\n  FindColumnsResponse,\n  FullPTableColumnData,\n  PColumnIdAndSpec,\n  PObjectId,\n  PTableRecordSingleValueFilterV2,\n  ValueType,\n} from \"@milaboratories/pl-model-common\";\nimport {\n  pTableValue,\n  Annotation,\n  canonicalizeAxisId,\n  getAxisId,\n  readAnnotation,\n  PColumnName,\n} from \"@milaboratories/pl-model-common\";\n\nexport * from \"./columns\";\n\n// Types\ntype PValue = string | number | null;\n\ntype SuggestionResponse = {\n  values: {\n    value: string;\n    label: string;\n  }[];\n  overflow: boolean;\n};\n\ntype SingleColumnData = {\n  axesData: Record<string, PValue[]>;\n  data: PValue[];\n};\n\ntype UniqueValuesResponse = {\n  values: string[];\n  overflow: boolean;\n};\n\ntype GetUniqueSourceValuesParams = {\n  columnId: PObjectId;\n  axisIdx?: number;\n  limit?: number;\n  searchQuery?: string;\n  searchQueryValue?: string;\n};\n\ntype GetAxisUniqueValuesParams = {\n  axisId: AxisId;\n  parentColumnIds: PObjectId[];\n  limit?: number;\n  filters?: PTableRecordSingleValueFilterV2[];\n};\n\ntype GetColumnsFullParams = {\n  selectedSources: PObjectId[];\n  strictlyCompatible: boolean;\n  types?: ValueType[];\n  names?: string[];\n  annotations?: FindColumnsRequest[\"columnFilter\"][\"annotationValue\"];\n  annotationsNotEmpty?: string[];\n};\n\n// Constants\nconst UNIQUE_VALUES_LIMIT = 1000000;\n\n// Helper functions\nconst sortValuesPredicate = (a: { label: string }, b: { label: string }) =>\n  a.label.localeCompare(b.label, \"en\", { numeric: true });\n\nfunction convertColumnData(\n  type: ValueType,\n  response: PTableVector,\n  absentValue: number | null = null,\n): PValue[] {\n  if (type === \"String\") {\n    return response.data as PValue[];\n  }\n  const res: PValue[] = new Array(response.data.length);\n  for (let i = 0; i < response.data.length; i++) {\n    res[i] = pTableValue(response, i, { absent: absentValue, na: null }) as PValue;\n  }\n  return res;\n}\n\nfunction createSearchFilter(\n  columnId: PObjectId,\n  substring: string,\n): PTableRecordSingleValueFilterV2 {\n  return {\n    type: \"bySingleColumnV2\",\n    column: {\n      type: \"column\",\n      id: columnId,\n    },\n    predicate: {\n      operator: \"StringIContains\",\n      substring,\n    },\n  };\n}\n\nfunction createAxisSearchFilter(\n  axisSpec: AxisSpec,\n  substring: string,\n): PTableRecordSingleValueFilterV2 {\n  return {\n    type: \"bySingleColumnV2\",\n    column: {\n      type: \"axis\",\n      id: {\n        type: axisSpec.type,\n        name: axisSpec.name,\n      },\n    },\n    predicate: {\n      operator: \"StringIContains\",\n      substring,\n    },\n  };\n}\n\nfunction mapValuesToSuggestions(values: string[]): { value: string; label: string }[] {\n  return values.map((v) => ({ value: String(v), label: String(v) })).sort(sortValuesPredicate);\n}\n\nfunction getPFrameDriver() {\n  if (typeof platforma === \"undefined\") {\n    throw new Error(\"Platforma instance is not available\");\n  }\n  if (typeof platforma.pFrameDriver === \"undefined\") {\n    throw new Error(\"PFrame driver is not available in the current Platforma instance\");\n  }\n  return platforma.pFrameDriver;\n}\n\n// Core functions\nexport async function getColumnSpecById(\n  handle: PFrameHandle,\n  id: PObjectId,\n): Promise<PColumnSpec | null> {\n  try {\n    const response = await getPFrameDriver().getColumnSpec(handle, id);\n    return response ?? null;\n  } catch (err) {\n    console.error(\"PFrame: get single column error\", err);\n    return null;\n  }\n}\n\nexport async function getSingleColumnData(\n  handle: PFrameHandle,\n  id: PObjectId,\n  filters: PTableRecordSingleValueFilterV2[] = [],\n): Promise<SingleColumnData> {\n  try {\n    const response: FullPTableColumnData[] = await getPFrameDriver().calculateTableData(handle, {\n      src: {\n        type: \"column\",\n        column: id,\n      },\n      filters,\n      sorting: [],\n    } as CalculateTableDataRequest<PObjectId>);\n\n    const axes = response.filter((item) => item.spec.type === \"axis\");\n    const columns = response.filter((item) => item.spec.type === \"column\");\n\n    return {\n      axesData: axes.reduce((res: Record<string, PValue[]>, item) => {\n        const id = getAxisId(item.spec.spec as AxisSpec);\n        res[canonicalizeAxisId(id)] = convertColumnData(id.type, item.data);\n        return res;\n      }, {}),\n      data: columns.length ? convertColumnData(columns[0].data.type, columns[0].data) : [],\n    };\n  } catch (err) {\n    console.error(\"PFrame: calculateTableData error\");\n    throw err;\n  }\n}\n\nexport async function getColumnUniqueValues(\n  handle: PFrameHandle,\n  id: PObjectId,\n  limit = UNIQUE_VALUES_LIMIT,\n  filters: PTableRecordSingleValueFilterV2[] = [],\n): Promise<UniqueValuesResponse> {\n  const request: UniqueValuesRequest = {\n    columnId: id,\n    filters,\n    limit,\n  };\n\n  try {\n    const response = await getPFrameDriver().getUniqueValues(handle, request);\n    if (response.overflow) {\n      console.warn(`More than ${limit} values for ${id} column`);\n    }\n    return {\n      values: Array.from(response.values.data as ArrayLike<unknown>).map(String),\n      overflow: response.overflow,\n    };\n  } catch (err) {\n    console.error(\"PFrame: getUniqueValues for column error\");\n    throw err;\n  }\n}\n\nexport async function getAxisUniqueValues(\n  handle: PFrameHandle,\n  params: GetAxisUniqueValuesParams,\n): Promise<UniqueValuesResponse> {\n  const { axisId, parentColumnIds, limit = UNIQUE_VALUES_LIMIT, filters = [] } = params;\n  const strAxisId = canonicalizeAxisId(axisId);\n\n  const parentsSpecs = (await Promise.all(parentColumnIds.map((p) => getColumnSpecById(handle, p))))\n    .flatMap((spec, i): [PObjectId, PColumnSpec][] =>\n      spec != null && spec.kind === \"PColumn\" ? [[parentColumnIds[i], spec]] : [],\n    )\n    .filter(([_, spec]) =>\n      spec.axesSpec.some((axisSpec) => canonicalizeAxisId(getAxisId(axisSpec)) === strAxisId),\n    );\n\n  if (parentsSpecs.length === 0) {\n    console.warn(\"Axis unique values requested without parent columns\");\n    return { values: [], overflow: false };\n  }\n\n  try {\n    const responses = await Promise.all(\n      parentsSpecs.map(([id]) =>\n        getPFrameDriver().getUniqueValues(handle, {\n          columnId: id,\n          axis: axisId,\n          filters,\n          limit,\n        }),\n      ),\n    );\n\n    const overflow = responses.some((r) => r.overflow);\n    return {\n      values: uniq(\n        flatten(responses.map((r) => Array.from(r.values.data as ArrayLike<unknown>).map(String))),\n      ),\n      overflow,\n    };\n  } catch (err) {\n    console.error(\"PFrame: getUniqueValues for axis error\", err);\n    return { values: [], overflow: false };\n  }\n}\n\nexport async function getRequestColumnsFromSelectedSources(\n  handle: PFrameHandle,\n  sources: PObjectId[],\n): Promise<AxisId[]> {\n  const result: AxisId[] = [];\n  for (const item of sources) {\n    const spec = await getColumnSpecById(handle, item);\n    if (spec?.kind === \"PColumn\") {\n      result.push(...spec.axesSpec.map((spec) => getAxisId(spec)));\n    }\n  }\n  return result;\n}\n\nexport async function getColumnsFull(\n  handle: PFrameHandle,\n  params: GetColumnsFullParams,\n): Promise<PColumnIdAndSpec[]> {\n  const { selectedSources, strictlyCompatible, types, names, annotations, annotationsNotEmpty } =\n    params;\n\n  try {\n    const request: FindColumnsRequest = {\n      columnFilter: {\n        type: types,\n        name: names,\n        annotationValue: annotations,\n        annotationPattern: annotationsNotEmpty?.reduce(\n          (res, v) => {\n            res[v] = \".+\";\n            return res;\n          },\n          {} as Record<string, string>,\n        ),\n      },\n      compatibleWith: await getRequestColumnsFromSelectedSources(handle, selectedSources),\n      strictlyCompatible,\n    };\n\n    const response: FindColumnsResponse = await getPFrameDriver().findColumns(handle, request);\n    return response.hits;\n  } catch (err) {\n    console.error(\"PFrame: findColumns error\");\n    throw err;\n  }\n}\n\nexport async function getColumnOrAxisValueLabelsId(\n  handle: PFrameHandle,\n  strAxisId: CanonicalizedJson<AxisId>,\n): Promise<PObjectId | undefined> {\n  const labelColumns = await getColumnsFull(handle, {\n    selectedSources: [],\n    strictlyCompatible: false,\n    names: [PColumnName.Label],\n  });\n\n  const labelColumn = labelColumns.find(({ spec }) => {\n    return spec && spec.axesSpec.length === 1 && canonicalizeAxisId(spec.axesSpec[0]) === strAxisId;\n  });\n\n  return labelColumn?.columnId;\n}\n\nfunction getDiscreteValuesFromAnnotation(columnSpec: PColumnSpec): undefined | SuggestionResponse {\n  const discreteValuesStr = readAnnotation(columnSpec, Annotation.DiscreteValues);\n  if (!discreteValuesStr) {\n    return undefined;\n  }\n\n  try {\n    const discreteValues: string[] = (JSON.parse(discreteValuesStr) as (string | number)[]).map(\n      (v) => String(v),\n    );\n    const values = discreteValues.map((v) => ({ value: v, label: v })).sort(sortValuesPredicate);\n    return { values, overflow: false };\n  } catch {\n    console.error(`Parsing error: discrete values annotation ${discreteValuesStr}`);\n    return undefined;\n  }\n}\n\nasync function getAxisValuesWithLabels(\n  handle: PFrameHandle,\n  params: {\n    columnId: PObjectId;\n    axisSpec: AxisSpec;\n    labelsColumnId: PObjectId | undefined;\n    limit?: number;\n    searchQuery?: string;\n    searchQueryValue?: string;\n  },\n): Promise<SuggestionResponse> {\n  const { columnId, axisSpec, labelsColumnId, limit, searchQuery, searchQueryValue } = params;\n  const strAxisId = canonicalizeAxisId(getAxisId(axisSpec));\n\n  let filters: PTableRecordSingleValueFilterV2[] = [];\n\n  if (labelsColumnId) {\n    if (searchQuery) {\n      filters = [createSearchFilter(labelsColumnId, searchQuery)];\n    }\n    if (searchQueryValue) {\n      filters = [createAxisSearchFilter(axisSpec, searchQueryValue)];\n    }\n\n    const { data: dataValues, axesData } = await getSingleColumnData(\n      handle,\n      labelsColumnId,\n      filters,\n    );\n    const axisKeys = axesData[strAxisId];\n    const values: { value: string; label: string }[] = [];\n\n    for (let i = 0; i < Math.min(axisKeys.length, limit ?? axisKeys.length); i++) {\n      values.push({ value: String(axisKeys[i]), label: String(dataValues[i]) });\n    }\n\n    values.sort(sortValuesPredicate);\n    return { values, overflow: !(limit === undefined || axisKeys.length < limit) };\n  } else {\n    const searchInLabelsOrValue = searchQuery ?? searchQueryValue;\n    if (searchInLabelsOrValue) {\n      filters = [createAxisSearchFilter(axisSpec, searchInLabelsOrValue)];\n    }\n\n    const response = await getAxisUniqueValues(handle, {\n      axisId: getAxisId(axisSpec),\n      parentColumnIds: [columnId],\n      limit,\n      filters,\n    });\n\n    const values = mapValuesToSuggestions(response.values);\n    return { values, overflow: response.overflow };\n  }\n}\n\nasync function getColumnValuesWithLabels(\n  handle: PFrameHandle,\n  params: {\n    columnId: PObjectId;\n    limit?: number;\n    searchQuery?: string;\n    searchQueryValue?: string;\n  },\n): Promise<SuggestionResponse> {\n  const { columnId, limit, searchQuery, searchQueryValue } = params;\n  const searchInLabelsOrValue = searchQuery ?? searchQueryValue;\n\n  const filters: PTableRecordSingleValueFilterV2[] = searchInLabelsOrValue\n    ? [createSearchFilter(columnId, searchInLabelsOrValue)]\n    : [];\n\n  const response = await getColumnUniqueValues(handle, columnId, limit, filters);\n  const values = mapValuesToSuggestions(response.values);\n  return { values, overflow: response.overflow };\n}\n\nexport async function getUniqueSourceValuesWithLabels(\n  handle: PFrameHandle,\n  params: GetUniqueSourceValuesParams,\n): Promise<SuggestionResponse> {\n  const { columnId, axisIdx, limit, searchQuery, searchQueryValue } = params;\n\n  const selectedSourceSpec = await getColumnSpecById(handle, columnId);\n  if (selectedSourceSpec == null || selectedSourceSpec.kind !== \"PColumn\") {\n    return { values: [], overflow: false };\n  }\n\n  // Try to get discrete values from annotation\n  const discreteValues = getDiscreteValuesFromAnnotation(selectedSourceSpec);\n  if (discreteValues != null) {\n    return discreteValues;\n  }\n\n  // Handle axis values\n  if (axisIdx != null) {\n    const axisSpec = selectedSourceSpec.axesSpec[axisIdx];\n    const strAxisId = canonicalizeAxisId(getAxisId(axisSpec));\n    const labelsColumnId = await getColumnOrAxisValueLabelsId(handle, strAxisId);\n\n    return getAxisValuesWithLabels(handle, {\n      columnId,\n      axisSpec,\n      labelsColumnId,\n      limit,\n      searchQuery,\n      searchQueryValue,\n    });\n  }\n\n  // Handle column values\n  return getColumnValuesWithLabels(handle, {\n    columnId,\n    limit,\n    searchQuery,\n    searchQueryValue,\n  });\n}\n"],"mappings":"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"}

package/dist/platforma.d.ts

@@ -1,61 +1,63 @@
-import type { BlockApiV1 } from "./block_api_v1";
-import type { BlockApiV2 } from "./block_api_v2";
-import type { BlockApiV3 } from "./block_api_v3";
-import type { BlockOutputsBase, BlockStateV3, DriverKit, OutputWithStatus } from "@milaboratories/pl-model-common";
-import type { SdkInfo } from "./version";
-import type { BlockStatePatch } from "./block_state_patch";
-import type { PluginInstance } from "./block_model";
-import type { PluginHandle, PluginFactoryLike } from "./plugin_handle";
+import { BlockStatePatch } from "./block_state_patch.js";
+import { PluginFactoryLike, PluginHandle } from "./plugin_handle.js";
+import { BlockApiV1 } from "./block_api_v1.js";
+import { BlockApiV2 } from "./block_api_v2.js";
+import { BlockApiV3 } from "./block_api_v3.js";
+import { SdkInfo } from "./version.js";
+import { PluginRecord } from "./block_model.js";
+import { BlockOutputsBase, BlockStateV3, DriverKit, OutputWithStatus } from "@milaboratories/pl-model-common";
+
+//#region src/platforma.d.ts
 /** Defines all methods to interact with the platform environment from within a block UI. @deprecated */
-export interface PlatformaV1<Args = unknown, Outputs extends Record<string, OutputWithStatus<unknown>> = Record<string, OutputWithStatus<unknown>>, UiState = unknown, Href extends `/${string}` = `/${string}`> extends BlockApiV1<Args, Outputs, UiState, Href>, DriverKit {
-    /** Information about SDK version current platforma environment was compiled with. */
-    readonly sdkInfo: SdkInfo;
-    readonly apiVersion?: 1;
+interface PlatformaV1<Args = unknown, Outputs extends Record<string, OutputWithStatus<unknown>> = Record<string, OutputWithStatus<unknown>>, UiState = unknown, Href extends `/${string}` = `/${string}`> extends BlockApiV1<Args, Outputs, UiState, Href>, DriverKit {
+  /** Information about SDK version current platforma environment was compiled with. */
+  readonly sdkInfo: SdkInfo;
+  readonly apiVersion?: 1;
 }
 /** V2 version based on effective json patches pulling API */
-export interface PlatformaV2<Args = unknown, Outputs extends Record<string, OutputWithStatus<unknown>> = Record<string, OutputWithStatus<unknown>>, UiState = unknown, Href extends `/${string}` = `/${string}`> extends BlockApiV2<Args, Outputs, UiState, Href>, DriverKit {
-    /** Information about SDK version current platforma environment was compiled with. */
-    readonly sdkInfo: SdkInfo;
-    readonly apiVersion: 2;
+interface PlatformaV2<Args = unknown, Outputs extends Record<string, OutputWithStatus<unknown>> = Record<string, OutputWithStatus<unknown>>, UiState = unknown, Href extends `/${string}` = `/${string}`> extends BlockApiV2<Args, Outputs, UiState, Href>, DriverKit {
+  /** Information about SDK version current platforma environment was compiled with. */
+  readonly sdkInfo: SdkInfo;
+  readonly apiVersion: 2;
 }
-export interface PlatformaV3<Data = unknown, Args = unknown, Outputs extends Record<string, OutputWithStatus<unknown>> = Record<string, OutputWithStatus<unknown>>, Href extends `/${string}` = `/${string}`, Plugins extends Record<string, unknown> = Record<string, unknown>> extends BlockApiV3<Data, Args, Outputs, Href>, DriverKit {
-    /** Information about SDK version current platforma environment was compiled with. */
-    readonly sdkInfo: SdkInfo;
-    readonly apiVersion: 3;
-    /** @internal Type brand for plugin type inference. Not used at runtime. */
-    readonly __pluginsBrand?: Plugins;
+interface PlatformaV3<Data = unknown, Args = unknown, Outputs extends Record<string, OutputWithStatus<unknown>> = Record<string, OutputWithStatus<unknown>>, Href extends `/${string}` = `/${string}`, Plugins extends Record<string, unknown> = Record<string, unknown>> extends BlockApiV3<Data, Args, Outputs, Href>, DriverKit {
+  /** Information about SDK version current platforma environment was compiled with. */
+  readonly sdkInfo: SdkInfo;
+  readonly apiVersion: 3;
+  /** @internal Type brand for plugin type inference. Not used at runtime. */
+  readonly __pluginsBrand?: Plugins;
 }
-export type Platforma<Args = unknown, Outputs extends Record<string, OutputWithStatus<unknown>> = Record<string, OutputWithStatus<unknown>>, UiStateOrData = unknown, Href extends `/${string}` = `/${string}`> = PlatformaV1<Args, Outputs, UiStateOrData, Href> | PlatformaV2<Args, Outputs, UiStateOrData, Href> | PlatformaV3<UiStateOrData, Args, Outputs, Href>;
-export type PlatformaExtended<Pl extends Platforma = Platforma> = Pl & {
-    blockModelInfo: BlockModelInfo;
+type Platforma<Args = unknown, Outputs extends Record<string, OutputWithStatus<unknown>> = Record<string, OutputWithStatus<unknown>>, UiStateOrData = unknown, Href extends `/${string}` = `/${string}`> = PlatformaV1<Args, Outputs, UiStateOrData, Href> | PlatformaV2<Args, Outputs, UiStateOrData, Href> | PlatformaV3<UiStateOrData, Args, Outputs, Href>;
+type PlatformaExtended<Pl extends Platforma = Platforma> = Pl & {
+  blockModelInfo: BlockModelInfo;
 };
-export type BlockModelInfo = {
-    outputs: Record<string, {
-        withStatus: boolean;
-    }>;
-    pluginIds: PluginHandle[];
+type BlockModelInfo = {
+  outputs: Record<string, {
+    withStatus: boolean;
+  }>;
+  pluginIds: PluginHandle[];
 };
-export type PlatformaApiVersion = Platforma["apiVersion"];
-export type InferArgsType<Pl extends Platforma> = Pl extends Platforma<infer Args> ? Args : never;
-export type InferOutputsType<Pl extends Platforma> = Pl extends Platforma<unknown, infer Outputs> ? Outputs : never;
-export type InferUiState<Pl extends Platforma> = Pl extends Platforma<unknown, Record<string, OutputWithStatus<unknown>>, infer UiState> ? UiState : never;
-export type InferDataType<Pl extends Platforma> = Pl extends Platforma<unknown, Record<string, OutputWithStatus<unknown>>, infer Data> ? Data : never;
-export type InferHrefType<Pl extends Platforma> = Pl extends Platforma<unknown, BlockOutputsBase, unknown, infer Href> ? Href : never;
-export type PlatformaFactory = (config: {
-    sdkVersion: string;
+type PlatformaApiVersion = Platforma["apiVersion"];
+type InferArgsType<Pl extends Platforma> = Pl extends Platforma<infer Args> ? Args : never;
+type InferOutputsType<Pl extends Platforma> = Pl extends Platforma<unknown, infer Outputs> ? Outputs : never;
+type InferUiState<Pl extends Platforma> = Pl extends Platforma<unknown, Record<string, OutputWithStatus<unknown>>, infer UiState> ? UiState : never;
+type InferDataType<Pl extends Platforma> = Pl extends Platforma<unknown, Record<string, OutputWithStatus<unknown>>, infer Data> ? Data : never;
+type InferHrefType<Pl extends Platforma> = Pl extends Platforma<unknown, BlockOutputsBase, unknown, infer Href> ? Href : never;
+type PlatformaFactory = (config: {
+  sdkVersion: string;
 }) => Platforma;
-export type InferBlockState<Pl extends Platforma> = BlockStateV3<InferDataType<Pl>, InferOutputsType<Pl>, InferHrefType<Pl>>;
-export type InferBlockStatePatch<Pl extends Platforma> = BlockStatePatch<InferArgsType<Pl>, InferOutputsType<Pl>, InferUiState<Pl>, InferHrefType<Pl>>;
+type InferBlockState<Pl extends Platforma> = BlockStateV3<InferDataType<Pl>, InferOutputsType<Pl>, InferHrefType<Pl>>;
+type InferBlockStatePatch<Pl extends Platforma> = BlockStatePatch<InferArgsType<Pl>, InferOutputsType<Pl>, InferUiState<Pl>, InferHrefType<Pl>>;
 /** Extract plugin IDs as a string literal union from a Platforma type. */
-export type InferPluginNames<Pl> = Pl extends PlatformaV3<unknown, unknown, BlockOutputsBase, `/${string}`, infer P> ? string & keyof P : never;
+type InferPluginNames<Pl> = Pl extends PlatformaV3<unknown, unknown, BlockOutputsBase, `/${string}`, infer P> ? string & keyof P : never;
 /** Extract the Data type for a specific plugin by its ID. */
-export type InferPluginData<Pl, PluginId extends string> = Pl extends PlatformaV3<unknown, unknown, BlockOutputsBase, `/${string}`, infer P> ? PluginId extends keyof P ? P[PluginId] extends PluginInstance<infer D, any, any> ? D : never : never : never;
+type InferPluginData<Pl, PluginId extends string> = Pl extends PlatformaV3<unknown, unknown, BlockOutputsBase, `/${string}`, infer P> ? PluginId extends keyof P ? P[PluginId] extends PluginRecord<infer D, any, any> ? D : never : never : never;
 /**
  * Map each plugin instance to a type-safe opaque handle branded with normalized phantom.
  * Uses the same brand structure as InferPluginHandle — only data/params/outputs, no config —
- * because PluginInstance doesn't carry Config (it's lost after factory.create()).
+ * because PluginRecord doesn't carry Config (lost after factory.create()).
  */
-export type InferPluginHandles<T extends Record<string, unknown>> = {
-    readonly [K in keyof T]: T[K] extends PluginInstance<infer Data, infer Params, infer Outputs> ? PluginHandle<PluginFactoryLike<Data, Params, Outputs>> : never;
-};
+type InferPluginHandles<T extends Record<string, unknown>> = { readonly [K in keyof T]: T[K] extends PluginRecord<infer Data, infer Params, infer Outputs> ? PluginHandle<PluginFactoryLike<Data, Params, Outputs>> : never };
+//#endregion
+export { BlockModelInfo, InferArgsType, InferBlockState, InferBlockStatePatch, InferDataType, InferHrefType, InferOutputsType, InferPluginData, InferPluginHandles, InferPluginNames, InferUiState, Platforma, PlatformaApiVersion, PlatformaExtended, PlatformaFactory, PlatformaV1, PlatformaV2, PlatformaV3 };
 //# sourceMappingURL=platforma.d.ts.map

package/dist/plugin_handle.cjs

@@ -1,29 +1,21 @@
-'use strict';
 
-/**
- * PluginHandle — Opaque branded handle and output key utilities for plugin instances.
- *
- * Extracted into its own module to break circular dependencies:
- * both block_storage.ts and plugin_model.ts can import from here
- * without depending on each other.
- *
- * @module plugin_handle
- */
+//#region src/plugin_handle.ts
 const PLUGIN_OUTPUT_PREFIX = "plugin-output#";
 /** Construct the output key for a plugin output in the block outputs map. */
 function pluginOutputKey(handle, outputKey) {
-    return `${PLUGIN_OUTPUT_PREFIX}${handle}#${outputKey}`;
+	return `${PLUGIN_OUTPUT_PREFIX}${handle}#${outputKey}`;
 }
 /** Check whether an output key belongs to a plugin (vs block-level output). */
 function isPluginOutputKey(key) {
-    return key.startsWith(PLUGIN_OUTPUT_PREFIX);
+	return key.startsWith(PLUGIN_OUTPUT_PREFIX);
 }
 /** Get the prefix used for all outputs of a specific plugin instance. */
 function pluginOutputPrefix(handle) {
-    return pluginOutputKey(handle, "");
+	return pluginOutputKey(handle, "");
 }
 
+//#endregion
 exports.isPluginOutputKey = isPluginOutputKey;
 exports.pluginOutputKey = pluginOutputKey;
 exports.pluginOutputPrefix = pluginOutputPrefix;
-//# sourceMappingURL=plugin_handle.cjs.map
+//# sourceMappingURL=plugin_handle.cjs.map

package/dist/plugin_handle.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin_handle.cjs","sources":["../src/plugin_handle.ts"],"sourcesContent":["/**\n * PluginHandle — Opaque branded handle and output key utilities for plugin instances.\n *\n * Extracted into its own module to break circular dependencies:\n * both block_storage.ts and plugin_model.ts can import from here\n * without depending on each other.\n *\n * @module plugin_handle\n */\n\nimport type { Branded } from \"@milaboratories/helpers\";\n\n/**\n * Phantom-only base type for constraining PluginHandle's type parameter.\n *\n * PluginFactory has create() → PluginModel with function properties, making it invariant\n * under strictFunctionTypes. PluginFactoryLike exposes only the covariant `__types` phantom,\n * avoiding the contravariance chain. Handles only need `__types` for type extraction.\n *\n * PluginFactory extends PluginFactoryLike, so every concrete factory satisfies this constraint.\n */\nexport interface PluginFactoryLike<\n  Data extends Record<string, unknown> = Record<string, unknown>,\n  Params extends undefined | Record<string, unknown> = undefined | Record<string, unknown>,\n  Outputs extends Record<string, unknown> = Record<string, unknown>,\n> {\n  readonly __types?: {\n    data: Data;\n    params: Params;\n    outputs: Outputs;\n  };\n}\n\n/** Extract the Data type from a PluginFactoryLike phantom. */\nexport type InferFactoryData<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<infer D, any, any> ? D : Record<string, unknown>\n>;\n\n/** Extract the Params type from a PluginFactoryLike phantom. */\nexport type InferFactoryParams<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, infer P, any> ? P : undefined\n>;\n\n/** Extract the Outputs type from a PluginFactoryLike phantom. */\nexport type InferFactoryOutputs<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, any, infer O> ? O : Record<string, unknown>\n>;\n\n/**\n * Derive a typed PluginHandle from a PluginFactory type.\n * Normalizes the brand to only data/params/outputs (strips config) so handles\n * from InferPluginHandles match handles from InferPluginHandle.\n */\nexport type InferPluginHandle<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<infer Data, infer Params, infer Outputs>\n    ? PluginHandle<PluginFactoryLike<Data, Params, Outputs>>\n    : PluginHandle\n>;\n\n/**\n * Opaque handle for a plugin instance. Runtime value is the plugin instance ID string.\n * Branded with factory phantom `F` for type-safe data/outputs extraction.\n * Constrained with PluginFactoryLike (not PluginFactory) to avoid variance issues.\n */\nexport type PluginHandle<F extends PluginFactoryLike = PluginFactoryLike> = Branded<string, F>;\n\nconst PLUGIN_OUTPUT_PREFIX = \"plugin-output#\";\n\n/** Construct the output key for a plugin output in the block outputs map. */\nexport function pluginOutputKey<F extends PluginFactoryLike>(\n  handle: PluginHandle<F>,\n  outputKey: string,\n): string {\n  return `${PLUGIN_OUTPUT_PREFIX}${handle}#${outputKey}`;\n}\n\n/** Check whether an output key belongs to a plugin (vs block-level output). */\nexport function isPluginOutputKey(key: string): boolean {\n  return key.startsWith(PLUGIN_OUTPUT_PREFIX);\n}\n\n/** Get the prefix used for all outputs of a specific plugin instance. */\nexport function pluginOutputPrefix<F extends PluginFactoryLike>(handle: PluginHandle<F>): string {\n  return pluginOutputKey(handle, \"\");\n}\n"],"names":[],"mappings":";;AAAA;;;;;;;;AAQG;AA0DH,MAAM,oBAAoB,GAAG,gBAAgB;AAE7C;AACM,SAAU,eAAe,CAC7B,MAAuB,EACvB,SAAiB,EAAA;AAEjB,IAAA,OAAO,GAAG,oBAAoB,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,SAAS,EAAE;AACxD;AAEA;AACM,SAAU,iBAAiB,CAAC,GAAW,EAAA;AAC3C,IAAA,OAAO,GAAG,CAAC,UAAU,CAAC,oBAAoB,CAAC;AAC7C;AAEA;AACM,SAAU,kBAAkB,CAA8B,MAAuB,EAAA;AACrF,IAAA,OAAO,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;AACpC;;;;;;"}
+{"version":3,"file":"plugin_handle.cjs","names":[],"sources":["../src/plugin_handle.ts"],"sourcesContent":["/**\n * PluginHandle — Opaque branded handle and output key utilities for plugin instances.\n *\n * Extracted into its own module to break circular dependencies:\n * both block_storage.ts and plugin_model.ts can import from here\n * without depending on each other.\n *\n * @module plugin_handle\n */\n\nimport type { Branded } from \"@milaboratories/helpers\";\n\n/**\n * Phantom-only base type for constraining PluginHandle's type parameter.\n *\n * PluginFactory has create() → PluginInstance with function properties, making it invariant\n * under strictFunctionTypes. PluginFactoryLike exposes only the covariant `__types` phantom,\n * avoiding the contravariance chain. Handles only need `__types` for type extraction.\n *\n * PluginFactory extends PluginFactoryLike, so every concrete factory satisfies this constraint.\n */\nexport interface PluginFactoryLike<\n  Data extends Record<string, unknown> = Record<string, unknown>,\n  Params extends undefined | Record<string, unknown> = undefined | Record<string, unknown>,\n  Outputs extends Record<string, unknown> = Record<string, unknown>,\n> {\n  readonly __types?: {\n    data: Data;\n    params: Params;\n    outputs: Outputs;\n  };\n}\n\n/** Extract the Data type from a PluginFactoryLike phantom. */\nexport type InferFactoryData<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<infer D, any, any> ? D : Record<string, unknown>\n>;\n\n/** Extract the Params type from a PluginFactoryLike phantom. */\nexport type InferFactoryParams<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, infer P, any> ? P : undefined\n>;\n\n/** Extract the Outputs type from a PluginFactoryLike phantom. */\nexport type InferFactoryOutputs<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, any, infer O> ? O : Record<string, unknown>\n>;\n\n/**\n * Derive a typed PluginHandle from a PluginFactory type.\n * Normalizes the brand to only data/params/outputs (strips config) so handles\n * from InferPluginHandles match handles from InferPluginHandle.\n */\nexport type InferPluginHandle<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<infer Data, infer Params, infer Outputs>\n    ? PluginHandle<PluginFactoryLike<Data, Params, Outputs>>\n    : PluginHandle\n>;\n\n/**\n * Opaque handle for a plugin instance. Runtime value is the plugin instance ID string.\n * Branded with factory phantom `F` for type-safe data/outputs extraction.\n * Constrained with PluginFactoryLike (not PluginFactory) to avoid variance issues.\n */\nexport type PluginHandle<F extends PluginFactoryLike = PluginFactoryLike> = Branded<string, F>;\n\nconst PLUGIN_OUTPUT_PREFIX = \"plugin-output#\";\n\n/** Construct the output key for a plugin output in the block outputs map. */\nexport function pluginOutputKey<F extends PluginFactoryLike>(\n  handle: PluginHandle<F>,\n  outputKey: string,\n): string {\n  return `${PLUGIN_OUTPUT_PREFIX}${handle}#${outputKey}`;\n}\n\n/** Check whether an output key belongs to a plugin (vs block-level output). */\nexport function isPluginOutputKey(key: string): boolean {\n  return key.startsWith(PLUGIN_OUTPUT_PREFIX);\n}\n\n/** Get the prefix used for all outputs of a specific plugin instance. */\nexport function pluginOutputPrefix<F extends PluginFactoryLike>(handle: PluginHandle<F>): string {\n  return pluginOutputKey(handle, \"\");\n}\n"],"mappings":";;AAkEA,MAAM,uBAAuB;;AAG7B,SAAgB,gBACd,QACA,WACQ;AACR,QAAO,GAAG,uBAAuB,OAAO,GAAG;;;AAI7C,SAAgB,kBAAkB,KAAsB;AACtD,QAAO,IAAI,WAAW,qBAAqB;;;AAI7C,SAAgB,mBAAgD,QAAiC;AAC/F,QAAO,gBAAgB,QAAQ,GAAG"}

package/dist/plugin_handle.d.ts

@@ -1,51 +1,46 @@
-/**
- * PluginHandle — Opaque branded handle and output key utilities for plugin instances.
- *
- * Extracted into its own module to break circular dependencies:
- * both block_storage.ts and plugin_model.ts can import from here
- * without depending on each other.
- *
- * @module plugin_handle
- */
-import type { Branded } from "@milaboratories/helpers";
+import { Branded } from "@milaboratories/helpers";
+
+//#region src/plugin_handle.d.ts
 /**
  * Phantom-only base type for constraining PluginHandle's type parameter.
  *
- * PluginFactory has create() → PluginModel with function properties, making it invariant
+ * PluginFactory has create() → PluginInstance with function properties, making it invariant
  * under strictFunctionTypes. PluginFactoryLike exposes only the covariant `__types` phantom,
  * avoiding the contravariance chain. Handles only need `__types` for type extraction.
  *
  * PluginFactory extends PluginFactoryLike, so every concrete factory satisfies this constraint.
  */
-export interface PluginFactoryLike<Data extends Record<string, unknown> = Record<string, unknown>, Params extends undefined | Record<string, unknown> = undefined | Record<string, unknown>, Outputs extends Record<string, unknown> = Record<string, unknown>> {
-    readonly __types?: {
-        data: Data;
-        params: Params;
-        outputs: Outputs;
-    };
+interface PluginFactoryLike<Data extends Record<string, unknown> = Record<string, unknown>, Params extends undefined | Record<string, unknown> = undefined | Record<string, unknown>, Outputs extends Record<string, unknown> = Record<string, unknown>> {
+  readonly __types?: {
+    data: Data;
+    params: Params;
+    outputs: Outputs;
+  };
 }
 /** Extract the Data type from a PluginFactoryLike phantom. */
-export type InferFactoryData<F extends PluginFactoryLike> = NonNullable<F extends PluginFactoryLike<infer D, any, any> ? D : Record<string, unknown>>;
+type InferFactoryData<F extends PluginFactoryLike> = NonNullable<F extends PluginFactoryLike<infer D, any, any> ? D : Record<string, unknown>>;
 /** Extract the Params type from a PluginFactoryLike phantom. */
-export type InferFactoryParams<F extends PluginFactoryLike> = NonNullable<F extends PluginFactoryLike<any, infer P, any> ? P : undefined>;
+type InferFactoryParams<F extends PluginFactoryLike> = NonNullable<F extends PluginFactoryLike<any, infer P, any> ? P : undefined>;
 /** Extract the Outputs type from a PluginFactoryLike phantom. */
-export type InferFactoryOutputs<F extends PluginFactoryLike> = NonNullable<F extends PluginFactoryLike<any, any, infer O> ? O : Record<string, unknown>>;
+type InferFactoryOutputs<F extends PluginFactoryLike> = NonNullable<F extends PluginFactoryLike<any, any, infer O> ? O : Record<string, unknown>>;
 /**
  * Derive a typed PluginHandle from a PluginFactory type.
  * Normalizes the brand to only data/params/outputs (strips config) so handles
  * from InferPluginHandles match handles from InferPluginHandle.
  */
-export type InferPluginHandle<F extends PluginFactoryLike> = NonNullable<F extends PluginFactoryLike<infer Data, infer Params, infer Outputs> ? PluginHandle<PluginFactoryLike<Data, Params, Outputs>> : PluginHandle>;
+type InferPluginHandle<F extends PluginFactoryLike> = NonNullable<F extends PluginFactoryLike<infer Data, infer Params, infer Outputs> ? PluginHandle<PluginFactoryLike<Data, Params, Outputs>> : PluginHandle>;
 /**
  * Opaque handle for a plugin instance. Runtime value is the plugin instance ID string.
  * Branded with factory phantom `F` for type-safe data/outputs extraction.
  * Constrained with PluginFactoryLike (not PluginFactory) to avoid variance issues.
  */
-export type PluginHandle<F extends PluginFactoryLike = PluginFactoryLike> = Branded<string, F>;
+type PluginHandle<F extends PluginFactoryLike = PluginFactoryLike> = Branded<string, F>;
 /** Construct the output key for a plugin output in the block outputs map. */
-export declare function pluginOutputKey<F extends PluginFactoryLike>(handle: PluginHandle<F>, outputKey: string): string;
+declare function pluginOutputKey<F extends PluginFactoryLike>(handle: PluginHandle<F>, outputKey: string): string;
 /** Check whether an output key belongs to a plugin (vs block-level output). */
-export declare function isPluginOutputKey(key: string): boolean;
+declare function isPluginOutputKey(key: string): boolean;
 /** Get the prefix used for all outputs of a specific plugin instance. */
-export declare function pluginOutputPrefix<F extends PluginFactoryLike>(handle: PluginHandle<F>): string;
+declare function pluginOutputPrefix<F extends PluginFactoryLike>(handle: PluginHandle<F>): string;
+//#endregion
+export { InferFactoryData, InferFactoryOutputs, InferFactoryParams, InferPluginHandle, PluginFactoryLike, PluginHandle, isPluginOutputKey, pluginOutputKey, pluginOutputPrefix };
 //# sourceMappingURL=plugin_handle.d.ts.map

package/dist/plugin_handle.js

@@ -1,25 +1,18 @@
-/**
- * PluginHandle — Opaque branded handle and output key utilities for plugin instances.
- *
- * Extracted into its own module to break circular dependencies:
- * both block_storage.ts and plugin_model.ts can import from here
- * without depending on each other.
- *
- * @module plugin_handle
- */
+//#region src/plugin_handle.ts
 const PLUGIN_OUTPUT_PREFIX = "plugin-output#";
 /** Construct the output key for a plugin output in the block outputs map. */
 function pluginOutputKey(handle, outputKey) {
-    return `${PLUGIN_OUTPUT_PREFIX}${handle}#${outputKey}`;
+	return `${PLUGIN_OUTPUT_PREFIX}${handle}#${outputKey}`;
 }
 /** Check whether an output key belongs to a plugin (vs block-level output). */
 function isPluginOutputKey(key) {
-    return key.startsWith(PLUGIN_OUTPUT_PREFIX);
+	return key.startsWith(PLUGIN_OUTPUT_PREFIX);
 }
 /** Get the prefix used for all outputs of a specific plugin instance. */
 function pluginOutputPrefix(handle) {
-    return pluginOutputKey(handle, "");
+	return pluginOutputKey(handle, "");
 }
 
+//#endregion
 export { isPluginOutputKey, pluginOutputKey, pluginOutputPrefix };
-//# sourceMappingURL=plugin_handle.js.map
+//# sourceMappingURL=plugin_handle.js.map

package/dist/plugin_handle.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin_handle.js","sources":["../src/plugin_handle.ts"],"sourcesContent":["/**\n * PluginHandle — Opaque branded handle and output key utilities for plugin instances.\n *\n * Extracted into its own module to break circular dependencies:\n * both block_storage.ts and plugin_model.ts can import from here\n * without depending on each other.\n *\n * @module plugin_handle\n */\n\nimport type { Branded } from \"@milaboratories/helpers\";\n\n/**\n * Phantom-only base type for constraining PluginHandle's type parameter.\n *\n * PluginFactory has create() → PluginModel with function properties, making it invariant\n * under strictFunctionTypes. PluginFactoryLike exposes only the covariant `__types` phantom,\n * avoiding the contravariance chain. Handles only need `__types` for type extraction.\n *\n * PluginFactory extends PluginFactoryLike, so every concrete factory satisfies this constraint.\n */\nexport interface PluginFactoryLike<\n  Data extends Record<string, unknown> = Record<string, unknown>,\n  Params extends undefined | Record<string, unknown> = undefined | Record<string, unknown>,\n  Outputs extends Record<string, unknown> = Record<string, unknown>,\n> {\n  readonly __types?: {\n    data: Data;\n    params: Params;\n    outputs: Outputs;\n  };\n}\n\n/** Extract the Data type from a PluginFactoryLike phantom. */\nexport type InferFactoryData<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<infer D, any, any> ? D : Record<string, unknown>\n>;\n\n/** Extract the Params type from a PluginFactoryLike phantom. */\nexport type InferFactoryParams<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, infer P, any> ? P : undefined\n>;\n\n/** Extract the Outputs type from a PluginFactoryLike phantom. */\nexport type InferFactoryOutputs<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, any, infer O> ? O : Record<string, unknown>\n>;\n\n/**\n * Derive a typed PluginHandle from a PluginFactory type.\n * Normalizes the brand to only data/params/outputs (strips config) so handles\n * from InferPluginHandles match handles from InferPluginHandle.\n */\nexport type InferPluginHandle<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<infer Data, infer Params, infer Outputs>\n    ? PluginHandle<PluginFactoryLike<Data, Params, Outputs>>\n    : PluginHandle\n>;\n\n/**\n * Opaque handle for a plugin instance. Runtime value is the plugin instance ID string.\n * Branded with factory phantom `F` for type-safe data/outputs extraction.\n * Constrained with PluginFactoryLike (not PluginFactory) to avoid variance issues.\n */\nexport type PluginHandle<F extends PluginFactoryLike = PluginFactoryLike> = Branded<string, F>;\n\nconst PLUGIN_OUTPUT_PREFIX = \"plugin-output#\";\n\n/** Construct the output key for a plugin output in the block outputs map. */\nexport function pluginOutputKey<F extends PluginFactoryLike>(\n  handle: PluginHandle<F>,\n  outputKey: string,\n): string {\n  return `${PLUGIN_OUTPUT_PREFIX}${handle}#${outputKey}`;\n}\n\n/** Check whether an output key belongs to a plugin (vs block-level output). */\nexport function isPluginOutputKey(key: string): boolean {\n  return key.startsWith(PLUGIN_OUTPUT_PREFIX);\n}\n\n/** Get the prefix used for all outputs of a specific plugin instance. */\nexport function pluginOutputPrefix<F extends PluginFactoryLike>(handle: PluginHandle<F>): string {\n  return pluginOutputKey(handle, \"\");\n}\n"],"names":[],"mappings":"AAAA;;;;;;;;AAQG;AA0DH,MAAM,oBAAoB,GAAG,gBAAgB;AAE7C;AACM,SAAU,eAAe,CAC7B,MAAuB,EACvB,SAAiB,EAAA;AAEjB,IAAA,OAAO,GAAG,oBAAoB,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,SAAS,EAAE;AACxD;AAEA;AACM,SAAU,iBAAiB,CAAC,GAAW,EAAA;AAC3C,IAAA,OAAO,GAAG,CAAC,UAAU,CAAC,oBAAoB,CAAC;AAC7C;AAEA;AACM,SAAU,kBAAkB,CAA8B,MAAuB,EAAA;AACrF,IAAA,OAAO,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC;AACpC;;;;"}
+{"version":3,"file":"plugin_handle.js","names":[],"sources":["../src/plugin_handle.ts"],"sourcesContent":["/**\n * PluginHandle — Opaque branded handle and output key utilities for plugin instances.\n *\n * Extracted into its own module to break circular dependencies:\n * both block_storage.ts and plugin_model.ts can import from here\n * without depending on each other.\n *\n * @module plugin_handle\n */\n\nimport type { Branded } from \"@milaboratories/helpers\";\n\n/**\n * Phantom-only base type for constraining PluginHandle's type parameter.\n *\n * PluginFactory has create() → PluginInstance with function properties, making it invariant\n * under strictFunctionTypes. PluginFactoryLike exposes only the covariant `__types` phantom,\n * avoiding the contravariance chain. Handles only need `__types` for type extraction.\n *\n * PluginFactory extends PluginFactoryLike, so every concrete factory satisfies this constraint.\n */\nexport interface PluginFactoryLike<\n  Data extends Record<string, unknown> = Record<string, unknown>,\n  Params extends undefined | Record<string, unknown> = undefined | Record<string, unknown>,\n  Outputs extends Record<string, unknown> = Record<string, unknown>,\n> {\n  readonly __types?: {\n    data: Data;\n    params: Params;\n    outputs: Outputs;\n  };\n}\n\n/** Extract the Data type from a PluginFactoryLike phantom. */\nexport type InferFactoryData<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<infer D, any, any> ? D : Record<string, unknown>\n>;\n\n/** Extract the Params type from a PluginFactoryLike phantom. */\nexport type InferFactoryParams<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, infer P, any> ? P : undefined\n>;\n\n/** Extract the Outputs type from a PluginFactoryLike phantom. */\nexport type InferFactoryOutputs<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<any, any, infer O> ? O : Record<string, unknown>\n>;\n\n/**\n * Derive a typed PluginHandle from a PluginFactory type.\n * Normalizes the brand to only data/params/outputs (strips config) so handles\n * from InferPluginHandles match handles from InferPluginHandle.\n */\nexport type InferPluginHandle<F extends PluginFactoryLike> = NonNullable<\n  F extends PluginFactoryLike<infer Data, infer Params, infer Outputs>\n    ? PluginHandle<PluginFactoryLike<Data, Params, Outputs>>\n    : PluginHandle\n>;\n\n/**\n * Opaque handle for a plugin instance. Runtime value is the plugin instance ID string.\n * Branded with factory phantom `F` for type-safe data/outputs extraction.\n * Constrained with PluginFactoryLike (not PluginFactory) to avoid variance issues.\n */\nexport type PluginHandle<F extends PluginFactoryLike = PluginFactoryLike> = Branded<string, F>;\n\nconst PLUGIN_OUTPUT_PREFIX = \"plugin-output#\";\n\n/** Construct the output key for a plugin output in the block outputs map. */\nexport function pluginOutputKey<F extends PluginFactoryLike>(\n  handle: PluginHandle<F>,\n  outputKey: string,\n): string {\n  return `${PLUGIN_OUTPUT_PREFIX}${handle}#${outputKey}`;\n}\n\n/** Check whether an output key belongs to a plugin (vs block-level output). */\nexport function isPluginOutputKey(key: string): boolean {\n  return key.startsWith(PLUGIN_OUTPUT_PREFIX);\n}\n\n/** Get the prefix used for all outputs of a specific plugin instance. */\nexport function pluginOutputPrefix<F extends PluginFactoryLike>(handle: PluginHandle<F>): string {\n  return pluginOutputKey(handle, \"\");\n}\n"],"mappings":";AAkEA,MAAM,uBAAuB;;AAG7B,SAAgB,gBACd,QACA,WACQ;AACR,QAAO,GAAG,uBAAuB,OAAO,GAAG;;;AAI7C,SAAgB,kBAAkB,KAAsB;AACtD,QAAO,IAAI,WAAW,qBAAqB;;;AAI7C,SAAgB,mBAAgD,QAAiC;AAC/F,QAAO,gBAAgB,QAAQ,GAAG"}