@astrato-io/visualizations 0.0.0-stage → 0.6.5

package/metadata.js

@@ -0,0 +1,20 @@
+import { i as e } from "./chunks/registry-CsQQzukD.js";
+import { n as t, r as n, t as r } from "./chunks/metadata-BGElBy5Z.js";
+import { t as i } from "./chunks/requirements-DYjZCFyf.js";
+var a = (e) => ({
+	type: e.type,
+	family: e.family,
+	capabilities: e.capabilities,
+	presets: e.presets ?? [],
+	requirements: e.requirements ?? i(e.type),
+	schemas: e.schemas ?? n(e.type),
+	operations: e.operations ?? t(e.type),
+	getters: e.getters ?? r(e.type),
+	description: e.description,
+	examples: e.examples
+}), o = Object.values(e).map(a), s = (t) => {
+	let n = e[t];
+	if (!n) throw Error(`Unsupported standalone visualization type: ${t}`);
+	return a(n);
+};
+export { a as createSerializableVisualizationMetadata, s as getVisualizationMetadata, o as visualizationMetadata };

package/operations.js

@@ -0,0 +1,64 @@
+import { js as e } from "./chunks/isEqual-BDxAhUo8.js";
+import { M as t, j as n } from "./chunks/shared-CBvcC5YV.js";
+import { t as r } from "./chunks/operations-CTNUX6Sy.js";
+import "./chunks/definitions-D3OVqmXl.js";
+import { i, n as a } from "./chunks/registry-CsQQzukD.js";
+import { n as o } from "./chunks/metadata-BGElBy5Z.js";
+var s = /* @__PURE__ */ new WeakMap(), c = (e, t) => {
+	let n = s.get(e);
+	n || (n = /* @__PURE__ */ new Map(), s.set(e, n));
+	let r = n.get(t);
+	if (!r) {
+		let i = {
+			generation: 0,
+			pendingCount: 0,
+			tail: Promise.resolve(),
+			unsubscribeInstanceChange: () => void 0,
+			vSpecRevision: 0
+		};
+		i.unsubscribeInstanceChange = e.onInstanceChange(t, (e) => {
+			e.reason === "vspec-updated" ? i.vSpecRevision += 1 : i.generation += 1;
+		}), n.set(t, i), r = i;
+	}
+	return {
+		queue: n,
+		state: r
+	};
+}, l = async (s) => {
+	let c = s.registry ?? i, l = a(s.instance.type, c), u = new Set((l.operations ?? o(l.type)).names);
+	if (s.operationRequests.forEach((e) => {
+		if (!u.has(e.name)) throw Error(`Unsupported operation for ${s.instance.type}: ${e.name}`);
+	}), !s.instance.vSpec) throw Error(`Cannot apply operations to ${s.instance.id}: missing vSpec.`);
+	let d = s.changesQueue ?? [], f = t(n(s.availableFields ?? [])), p = await r(s.instance.vSpec, f, s.operationRequests, s.variables ?? [], d, s.vTheme);
+	return s.operationRequests.length > 0 && d.push({
+		change: p.vSpecChange,
+		id: e(),
+		timestamp: Date.now()
+	}), {
+		results: p.results,
+		vSpec: p.vSpec
+	};
+}, u = async (e) => {
+	let { instanceId: t, runtime: n, ...r } = e, { queue: i, state: a } = c(n, t), o = a.generation;
+	a.pendingCount += 1;
+	let s = a.tail.then(async () => {
+		for (;;) {
+			if (a.generation !== o) throw Error(`Visualization instance ${t} changed while operations were pending.`);
+			let e = n.getInstance(t), i = a.vSpecRevision, s = r.changesQueue ? [...r.changesQueue] : void 0, c = await l({
+				...r,
+				changesQueue: s,
+				instance: e
+			});
+			if (a.generation !== o) throw Error(`Visualization instance ${t} changed while operations were running.`);
+			let u = n.getInstance(t);
+			if (!(a.vSpecRevision !== i || u.vSpec !== e.vSpec)) return r.changesQueue && s && r.changesQueue.splice(0, r.changesQueue.length, ...s), n.updateInstance(t, { vSpec: c.vSpec }), c;
+		}
+	});
+	a.tail = s.then(() => void 0, () => void 0);
+	try {
+		return await s;
+	} finally {
+		--a.pendingCount, a.pendingCount === 0 && i.get(t) === a && (a.unsubscribeInstanceChange(), i.delete(t));
+	}
+};
+export { l as applyOperations, u as applyRuntimeOperations };

package/package.json

@@ -1,6 +1,187 @@
 {
   "name": "@astrato-io/visualizations",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.6.5",
+  "type": "module",
+  "main": "./index.js",
+  "types": "./src/index.d.ts",
+  "dependencies": {
+    "rxjs": "^7.8.1",
+    "zod": "4.6.6"
+  },
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    },
+    "./operations": {
+      "types": "./src/operations/index.d.ts",
+      "import": "./operations.js",
+      "default": "./operations.js"
+    },
+    "./getters": {
+      "types": "./src/getters/index.d.ts",
+      "import": "./getters.js",
+      "default": "./getters.js"
+    },
+    "./metadata": {
+      "types": "./src/metadata/index.d.ts",
+      "import": "./metadata.js",
+      "default": "./metadata.js"
+    },
+    "./definitions": {
+      "types": "./src/definitions/index.d.ts",
+      "import": "./definitions.js",
+      "default": "./definitions.js"
+    },
+    "./styles.css": "./styles.css",
+    "./docs/operations/*": "./docs/operations/*",
+    "./VISUALIZATION_DEFINITIONS.md": "./VISUALIZATION_DEFINITIONS.md"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "files": [
+    "CHANGELOG.md",
+    "LICENSE",
+    "README.md",
+    "THIRD_PARTY_NOTICES.md",
+    "VISUALIZATION_DEFINITIONS.md",
+    "chunks/ClickAwayListener-BbeNMAvj.js",
+    "chunks/LinearProgress-B1FeWaen.js",
+    "chunks/accessors-DemrDevR.js",
+    "chunks/app-filter-bar.compiler-BGJ7HAbr.js",
+    "chunks/bar.compiler-CT0ZbQKc.js",
+    "chunks/builder-B6dWSIdD.js",
+    "chunks/color-settings-ZIvgNTq1.js",
+    "chunks/coloring-B1XAfg6b.js",
+    "chunks/debounce-fn-CUixuz45.js",
+    "chunks/definitions-D3OVqmXl.js",
+    "chunks/escobar-eDjtGpkC.js",
+    "chunks/events-WZut5Ow6.js",
+    "chunks/extend-BKUkc4_i.js",
+    "chunks/filter.compiler-DBsyRBJt.js",
+    "chunks/filtering-tqjAyJH5.js",
+    "chunks/grouping-type-On4s9Thj.js",
+    "chunks/handlers-VTBfIZYZ.js",
+    "chunks/isEqual-BDxAhUo8.js",
+    "chunks/line.compiler-CzdM5Ld0.js",
+    "chunks/metadata-BGElBy5Z.js",
+    "chunks/number.compiler-G-R7y16P.js",
+    "chunks/operations-CTNUX6Sy.js",
+    "chunks/range-CiwTbMig.js",
+    "chunks/registry-CsQQzukD.js",
+    "chunks/requirements-DYjZCFyf.js",
+    "chunks/rolldown-runtime-DleVn1XH.js",
+    "chunks/set-coloring-datafield-B3uIS1Pe.js",
+    "chunks/shared-CBvcC5YV.js",
+    "chunks/src-BOS6SqkZ.js",
+    "chunks/src-D9XogOrc.js",
+    "chunks/standalone-0M4HlmDW2.js",
+    "chunks/standalone-0ashe9w1.js",
+    "chunks/standalone-B7jax8wa.js",
+    "chunks/standalone-BK0VYU-l.js",
+    "chunks/standalone-BMIbT1b2.js",
+    "chunks/standalone-BZV5vOwA.js",
+    "chunks/standalone-BhDrWj4p.js",
+    "chunks/standalone-BtSHCp2U2.js",
+    "chunks/standalone-BvaKdky9.js",
+    "chunks/standalone-BwtM31-f.js",
+    "chunks/standalone-C3gg736V.js",
+    "chunks/standalone-CC1VUjO32.js",
+    "chunks/standalone-C_rYnZ0N.js",
+    "chunks/standalone-CoLrAxRV.js",
+    "chunks/standalone-DC-aUgXC.js",
+    "chunks/standalone-DCtRoTWg.js",
+    "chunks/standalone-DUDFTBqL.js",
+    "chunks/standalone-DhZkX9Td.js",
+    "chunks/standalone-DtLElfuM.js",
+    "chunks/standalone-G9Q4Uczu.js",
+    "chunks/standalone-JuLF-OoH.js",
+    "chunks/standalone-_DeX21JJ.js",
+    "chunks/standalone-gFhKZh8m.js",
+    "chunks/standalone-tDNy-SFH.js",
+    "chunks/standalone-v1oxfU20.js",
+    "chunks/standalone-vzBY6q0I2.js",
+    "chunks/stroke-dash-UgMEcCS4.js",
+    "chunks/table.compiler-tb914oj3.js",
+    "chunks/typeof-CJDtcySz.js",
+    "chunks/ui-DQWtv2iM.js",
+    "chunks/url-utils-B17gj_mr.js",
+    "chunks/useFieldName-BvdcoJRl.js",
+    "chunks/utils-Bg7K-t6K.js",
+    "chunks/view-Bn83C8d9.js",
+    "definitions.js",
+    "docs/operations/astrato-app-filter-bar.md",
+    "docs/operations/bar.md",
+    "docs/operations/combo.md",
+    "docs/operations/date-picker.md",
+    "docs/operations/distribution-gauge.md",
+    "docs/operations/dot.md",
+    "docs/operations/filter.md",
+    "docs/operations/gauge.md",
+    "docs/operations/heatMap.md",
+    "docs/operations/histogram.md",
+    "docs/operations/iframe.md",
+    "docs/operations/image.md",
+    "docs/operations/index.md",
+    "docs/operations/line.md",
+    "docs/operations/number.md",
+    "docs/operations/pie.md",
+    "docs/operations/radar.md",
+    "docs/operations/sankey.md",
+    "docs/operations/scatter.md",
+    "docs/operations/shape.md",
+    "docs/operations/simpleTextObject.md",
+    "docs/operations/slider.md",
+    "docs/operations/table.md",
+    "docs/operations/tree.md",
+    "docs/operations/treemap.md",
+    "docs/operations/waterfall.md",
+    "docs/operations/word-cloud.md",
+    "getters.js",
+    "index.js",
+    "metadata.js",
+    "operations.js",
+    "package.json",
+    "src/definitions/index.d.ts",
+    "src/definitions/model/definitions/available-fields.d.ts",
+    "src/definitions/model/definitions/compilers/compile.d.ts",
+    "src/definitions/model/definitions/data-item-resolution.d.ts",
+    "src/definitions/model/definitions/descriptors/descriptor-metadata.d.ts",
+    "src/definitions/model/definitions/descriptors/json-schema.d.ts",
+    "src/definitions/model/definitions/diagnostics.d.ts",
+    "src/definitions/model/definitions/field-suggestions.d.ts",
+    "src/definitions/model/definitions/index.d.ts",
+    "src/definitions/model/definitions/registry/compile.d.ts",
+    "src/definitions/model/definitions/registry/descriptor-registry.d.ts",
+    "src/definitions/model/definitions/schema-registry.d.ts",
+    "src/definitions/model/definitions/schemas/app-filter-bar.schema.d.ts",
+    "src/definitions/model/definitions/schemas/bar.schema.d.ts",
+    "src/definitions/model/definitions/schemas/broad-chart.schema.d.ts",
+    "src/definitions/model/definitions/schemas/common.schema.d.ts",
+    "src/definitions/model/definitions/schemas/filter.schema.d.ts",
+    "src/definitions/model/definitions/schemas/index.d.ts",
+    "src/definitions/model/definitions/schemas/line.schema.d.ts",
+    "src/definitions/model/definitions/schemas/number.schema.d.ts",
+    "src/definitions/model/definitions/schemas/object.schema.d.ts",
+    "src/definitions/model/definitions/schemas/table.schema.d.ts",
+    "src/definitions/model/definitions/types/compilation.types.d.ts",
+    "src/definitions/model/definitions/types/definition.types.d.ts",
+    "src/definitions/model/definitions/types/descriptor.types.d.ts",
+    "src/definitions/model/definitions/types/index.d.ts",
+    "src/definitions/model/definitions/validation.d.ts",
+    "src/getters/index.d.ts",
+    "src/index.d.ts",
+    "src/metadata/index.d.ts",
+    "src/operations/index.d.ts",
+    "src/registry/index.d.ts",
+    "src/runtime/index.d.ts",
+    "src/types.d.ts",
+    "src/visualization-catalog.d.ts",
+    "src/web-components/index.d.ts",
+    "styles.css"
+  ]
+}

package/src/definitions/index.d.ts

@@ -0,0 +1,2 @@
+export { compileVisualizationDefinition, getVisualizationDefinitionDescriptor, listVisualizationDefinitionDescriptors, createVisualizationAvailableFields, validateVisualizationDefinition, } from "./model/definitions";
+export type { AtomicInputVisualizationDefinition, BarVisualizationDefinition, BroadChartVisualizationDefinition, ComboVisualizationDefinition, CompileVisualizationDefinitionInput, CompileVisualizationDefinitionResult, DatePickerVisualizationDefinition, DistributionGaugeVisualizationDefinition, DotVisualizationDefinition, FilterVisualizationDefinition, GaugeVisualizationDefinition, HeatMapVisualizationDefinition, HistogramVisualizationDefinition, IframeVisualizationDefinition, ImageVisualizationDefinition, LineVisualizationDefinition, NumberVisualizationDefinition, PieVisualizationDefinition, RadarVisualizationDefinition, SankeyVisualizationDefinition, ScatterVisualizationDefinition, SerializableVisualizationDefinitionDescriptor, ShapeVisualizationDefinition, SliderVisualizationDefinition, TableVisualizationDefinition, TextVisualizationDefinition, TreeVisualizationDefinition, TreemapVisualizationDefinition, VisualizationAvailableField, VisualizationAvailableFieldsInput, VisualizationDefinition, VisualizationDefinitionDescriptor, VisualizationDefinitionDocumentation, VisualizationDefinitionFeature, VisualizationDefinitionIssue, VisualizationDefinitionIssueCode, VisualizationDefinitionValidationResult, VisualizationFieldMetadataInput, VisualizationResolvedDataItemReference, VisualizationResolvedReference, VisualizationStaticFilterGroup, WaterfallVisualizationDefinition, WordCloudVisualizationDefinition, } from "./model/definitions";

package/src/definitions/model/definitions/available-fields.d.ts

@@ -0,0 +1,35 @@
+import { type VisualizationAvailableField } from './schemas';
+interface OperationAvailableField {
+    aggregators: Array<{
+        disabled?: boolean;
+        funcName: string;
+        label: string;
+        requiredExtraParams: boolean;
+        resultType?: string;
+    }>;
+    calculation?: unknown;
+    dataType?: string;
+    dimension?: unknown;
+    id?: string;
+    isManualData?: boolean;
+    key: string;
+    measure?: unknown;
+    name: string;
+    type?: string;
+    view?: string;
+    views?: string[];
+}
+export interface VisualizationFieldMetadataInput {
+    dimensions?: unknown[];
+    fields?: unknown[];
+    measures?: unknown[];
+}
+export type VisualizationAvailableFieldsInput = unknown[] | VisualizationFieldMetadataInput;
+export type VisualizationAvailableFieldRole = 'dimension' | 'measure';
+export type VisualizationMeasureSourceKind = 'field' | 'measure' | 'calculation';
+export declare const createVisualizationAvailableFields: (input: VisualizationAvailableFieldsInput) => VisualizationAvailableField[];
+export declare const getVisualizationAvailableAggregationNames: (field: VisualizationAvailableField) => string[];
+export declare const isVisualizationAvailableFieldCompatibleWithRole: (field: VisualizationAvailableField, role: VisualizationAvailableFieldRole) => boolean;
+export declare const getVisualizationMeasureSourceKind: (field: VisualizationAvailableField) => VisualizationMeasureSourceKind | undefined;
+export declare const toOperationAvailableFields: (fields: VisualizationAvailableField[]) => OperationAvailableField[];
+export {};

package/src/definitions/model/definitions/compilers/compile.d.ts

@@ -0,0 +1,7 @@
+import { type CompileVisualizationDefinitionInput, type CompileVisualizationDefinitionResult } from '../types/compilation.types';
+export declare const compileAppFilterBarVisualizationDefinition: (input: CompileVisualizationDefinitionInput) => Promise<CompileVisualizationDefinitionResult>;
+export declare const compileBarVisualizationDefinition: (input: CompileVisualizationDefinitionInput) => Promise<CompileVisualizationDefinitionResult>;
+export declare const compileFilterVisualizationDefinition: (input: CompileVisualizationDefinitionInput) => Promise<CompileVisualizationDefinitionResult>;
+export declare const compileLineVisualizationDefinition: (input: CompileVisualizationDefinitionInput) => Promise<CompileVisualizationDefinitionResult>;
+export declare const compileNumberVisualizationDefinition: (input: CompileVisualizationDefinitionInput) => Promise<CompileVisualizationDefinitionResult>;
+export declare const compileTableVisualizationDefinition: (input: CompileVisualizationDefinitionInput) => Promise<CompileVisualizationDefinitionResult>;

package/src/definitions/model/definitions/data-item-resolution.d.ts

@@ -0,0 +1,19 @@
+import { type VisualizationAvailableFieldRole } from './available-fields';
+import type { VisualizationAvailableField, VisualizationStaticFilterGroup } from './schemas';
+import type { VisualizationDefinitionIssue } from './types';
+export interface DataDefinitionItem {
+    aggregation?: string;
+    fieldKey: string;
+    ref: string;
+    showNullValues?: boolean;
+    temporalGrouping?: object;
+}
+export declare const getSupportedAggregationNames: (field: VisualizationAvailableField) => string[];
+export declare const getCanonicalAggregation: (item: DataDefinitionItem, fields: VisualizationAvailableField[]) => string | undefined;
+export declare const getMeasureAggregation: (item: DataDefinitionItem, fields: VisualizationAvailableField[]) => string | undefined;
+export declare const getMeasureAddPayload: (item: DataDefinitionItem, fields: VisualizationAvailableField[], additionalPayload?: Record<string, unknown>) => Record<string, unknown>;
+export declare const validateDefinitionDataItem: (item: DataDefinitionItem, fields: VisualizationAvailableField[], path: Array<string | number>, role: VisualizationAvailableFieldRole) => VisualizationDefinitionIssue[];
+export declare const validateDefinitionDataItems: (items: DataDefinitionItem[], fields: VisualizationAvailableField[], pathPrefix: Array<string | number>, role: VisualizationAvailableFieldRole) => VisualizationDefinitionIssue[];
+/** Validates type-specific visualization requirements when the engine exposes a raw field data type. */
+export declare const validateRawFieldDataType: (item: DataDefinitionItem, fields: VisualizationAvailableField[], path: Array<string | number>, allowedDataTypes: readonly string[], usage: string) => VisualizationDefinitionIssue[];
+export declare const validateDefinitionFilterGroupFields: (filterGroup: VisualizationStaticFilterGroup | undefined, fields: VisualizationAvailableField[], path?: Array<string | number>) => VisualizationDefinitionIssue[];