@malloydata/render 0.0.330 → 0.0.331

package/dist/module/plugins/big-value/big-value-component.d.ts

@@ -0,0 +1,17 @@
+import { Field, NestCell } from '../../data_tree';
+import { BigValueSettings } from './big-value-settings';
+/**
+ * Props for the BigValueComponent
+ */
+export interface BigValueComponentProps {
+    /** The data cell containing the row(s) */
+    dataColumn: NestCell;
+    /** Field metadata */
+    field: Field;
+    /** Plugin settings */
+    settings: BigValueSettings;
+}
+/**
+ * Main Big Value component
+ */
+export declare function BigValueComponent(props: BigValueComponentProps): import("solid-js").JSX.Element;

package/dist/module/plugins/big-value/big-value-plugin.d.ts

@@ -0,0 +1,42 @@
+import { RenderPluginFactory, CoreVizPluginInstance } from '../../api/plugin-types';
+import { NestField } from '../../data_tree';
+import { BigValueSettings } from './big-value-settings';
+/**
+ * Metadata returned by the Big Value plugin
+ */
+interface BigValuePluginMetadata {
+    type: 'big_value';
+    field: NestField;
+    settings: BigValueSettings;
+}
+/**
+ * Big Value plugin instance type
+ * Extends CoreVizPluginInstance for storybook compatibility
+ */
+export interface BigValuePluginInstance extends CoreVizPluginInstance<BigValuePluginMetadata> {
+    field: NestField;
+}
+/**
+ * Big Value Plugin Factory
+ *
+ * Renders aggregate values as prominent metric cards.
+ *
+ * Usage in Malloy:
+ *   # big_value
+ *   run: my_source -> {
+ *     aggregate:
+ *       opportunity_count
+ *       total_revenue
+ *   }
+ *
+ * With comparison values:
+ *   # big_value
+ *   run: my_source -> {
+ *     aggregate:
+ *       opportunity_win_rate_ytd
+ *       # big_value { comparison_field='opportunity_win_rate_ytd' comparison_label='vs Prior Year' comparison_format='ppt' }
+ *       opportunity_win_rate_prior_year
+ *   }
+ */
+export declare const BigValuePluginFactory: RenderPluginFactory<BigValuePluginInstance>;
+export {};

package/dist/module/plugins/big-value/big-value-settings.d.ts

@@ -0,0 +1,46 @@
+import { JSONSchemaObject } from '../../api/json-schema-types';
+/**
+ * Size preset for big value cards
+ */
+export type BigValueSize = 'sm' | 'md' | 'lg';
+/**
+ * Comparison format type
+ * - 'pct': Percentage change (e.g., +5.2%)
+ * - 'ppt': Percentage point difference (e.g., +5.0 ppt)
+ */
+export type ComparisonFormat = 'pct' | 'ppt';
+/**
+ * Settings for the Big Value plugin
+ */
+export interface BigValueSettings extends Record<string, unknown> {
+    /** Size preset for the cards */
+    size: BigValueSize;
+    /** Threshold below which delta values are considered neutral (default: 0.05) */
+    neutralThreshold: number;
+}
+/**
+ * Comparison information extracted from field tags
+ * Used when a field has # big_value { comparison_field=... }
+ */
+export interface BigValueComparisonInfo {
+    /** The field name of the primary metric this comparison refers to */
+    comparisonField: string;
+    /** Optional label shown next to the delta (e.g., 'vs Prior Year') */
+    comparisonLabel?: string;
+    /** Format for the comparison: 'pct' for percentage change, 'ppt' for percentage points */
+    comparisonFormat: ComparisonFormat;
+    /** If true, a decrease is shown as positive (green) instead of negative */
+    downIsGood: boolean;
+}
+/**
+ * Default settings for the Big Value plugin
+ */
+export declare const defaultBigValueSettings: BigValueSettings;
+/**
+ * JSON Schema for Big Value settings
+ */
+export declare const bigValueSettingsSchema: JSONSchemaObject;
+/**
+ * Type for the settings schema
+ */
+export type IBigValueSettingsSchema = typeof bigValueSettingsSchema;

package/dist/module/plugins/big-value/index.d.ts

@@ -0,0 +1,2 @@
+export { BigValuePluginFactory, type BigValuePluginInstance, } from './big-value-plugin';
+export { type BigValueSettings, type BigValueComparisonInfo, type ComparisonFormat, type BigValueSize, defaultBigValueSettings, bigValueSettingsSchema, type IBigValueSettingsSchema, } from './big-value-settings';

package/dist/module/plugins/big-value/settings-to-tag.d.ts

@@ -0,0 +1,3 @@
+import { Tag } from '@malloydata/malloy-tag';
+import { BigValueSettings } from './big-value-settings';
+export declare function bigValueSettingsToTag(settings: BigValueSettings): Tag;

package/dist/module/plugins/index.d.ts

@@ -1,4 +1,5 @@
 export { type ILineChartSettingsSchema, lineChartSettingsSchema, defaultLineChartSettings, type LineChartSettings, } from './line-chart/line-chart-settings';
 export { type IBarChartSettingsSchema, barChartSettingsSchema, defaultBarChartSettings, type BarChartSettings, } from './bar-chart/bar-chart-settings';
 export { BarChartPluginFactory, type BarChartPluginInstance, } from './bar-chart/bar-chart-plugin';
+export { BigValuePluginFactory, type BigValuePluginInstance, type BigValueSettings, type BigValueComparisonInfo, type ComparisonFormat, type BigValueSize, defaultBigValueSettings, bigValueSettingsSchema, type IBigValueSettingsSchema, } from './big-value';
 export { ErrorPlugin } from './error/error-plugin';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@malloydata/render",
-  "version": "0.0.330",
+  "version": "0.0.331",
   "license": "MIT",
   "main": "dist/module/index.umd.js",
   "types": "dist/module/index.d.ts",
@@ -29,9 +29,9 @@
     "generate-flow": "ts-node ../../scripts/gen-flow.ts"
   },
   "dependencies": {
-    "@malloydata/malloy": "0.0.330",
-    "@malloydata/malloy-interfaces": "0.0.330",
-    "@malloydata/malloy-tag": "0.0.330",
+    "@malloydata/malloy": "0.0.331",
+    "@malloydata/malloy-interfaces": "0.0.331",
+    "@malloydata/malloy-tag": "0.0.331",
     "@tanstack/solid-virtual": "^3.10.4",
     "lodash": "^4.17.20",
     "luxon": "^3.5.0",
@@ -43,7 +43,7 @@
     "vega-lite": "^5.2.0"
   },
   "devDependencies": {
-    "@malloydata/db-duckdb": "0.0.330",
+    "@malloydata/db-duckdb": "0.0.331",
     "@storybook/addon-essentials": "^8.5.8",
     "@storybook/addon-interactions": "^8.5.8",
     "@storybook/addon-links": "^8.5.8",