@malloydata/render 0.0.330 → 0.0.331

package/.storybook/registered_data.json

@@ -1 +1 @@
-["products.parquet", "logos.csv", "missing_data.csv"]
+["products.parquet", "logos.csv", "missing_data.csv", "order_items.parquet"]

package/dist/module/component/render-numeric-field.d.ts

@@ -1,11 +1,31 @@
 import { RenderTimeStringOptions } from '../util';
-import { Field } from '../data_tree';
+import { Field, NumberCell } from '../data_tree';
 export declare function renderNumericField(f: Field, value: number | null | undefined): string;
 /**
  * Render a big number value (stored as string for precision).
  * Used when NumberCell.stringValue is defined (bigint/bigdecimal subtypes).
  * Default formatting preserves full precision with comma separators.
- * Explicit format tags (currency, percent, etc.) may be lossy for values > 2^53.
+ *
+ * Note: percent, duration, and custom number formats are lossy for values > 2^53
+ * because they require numeric operations. Currency preserves precision.
  */
 export declare function renderBigNumberField(f: Field, value: string | null | undefined): string;
+/**
+ * Render a NumberCell for display, automatically handling bigint precision.
+ *
+ * USE THIS FUNCTION when rendering numeric values from cells in plugins/components.
+ *
+ * Why this exists:
+ * - NumberCell.value is always a JS number, which loses precision for integers > 2^53
+ * - NumberCell.stringValue preserves full precision for bigint fields
+ * - This function automatically picks the right representation
+ *
+ * Example:
+ *   import {renderNumberCell} from '@/component/render-numeric-field';
+ *   const displayValue = renderNumberCell(cell);
+ *
+ * @param cell - A NumberCell from the data tree
+ * @returns Formatted string for display, respecting field tags (currency, percent, etc.)
+ */
+export declare function renderNumberCell(cell: NumberCell): string;
 export declare function renderDateTimeField(f: Field, value: Date | null | undefined, options?: RenderTimeStringOptions): string;

package/dist/module/data_tree/cells/atomic.d.ts

@@ -10,19 +10,15 @@ export declare class NullCell extends CellBase {
     get value(): null;
     get literalValue(): Malloy.LiteralValue | undefined;
 }
-/** Type for either regular or big number cells from Thrift */
-type NumberCellInput = Malloy.CellWithNumberCell | Malloy.CellWithBigNumberCell;
 /**
  * Unified cell for all numeric values.
  * Handles both regular numbers and big numbers (bigint/bigdecimal).
  */
 export declare class NumberCell extends CellBase {
-    readonly cell: NumberCellInput;
+    readonly cell: Malloy.CellWithNumberCell;
     readonly field: NumberField;
     readonly parent: NestCell | undefined;
-    private readonly _value;
-    private readonly _stringValue;
-    constructor(cell: NumberCellInput, field: NumberField, parent: NestCell | undefined);
+    constructor(cell: Malloy.CellWithNumberCell, field: NumberField, parent: NestCell | undefined);
     /**
      * Returns the numeric value as a JS number.
      * May be lossy for bigint/bigdecimal values > 2^53.
@@ -109,4 +105,3 @@ export declare class BooleanCell extends CellBase {
     compareTo(other: Cell): 1 | 0 | -1;
     get literalValue(): Malloy.LiteralValue | undefined;
 }
-export {};