@malloydata/render 0.0.329 → 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,4 +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.
+ *
+ * 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,38 +10,42 @@ export declare class NullCell extends CellBase {
     get value(): null;
     get literalValue(): Malloy.LiteralValue | undefined;
 }
+/**
+ * Unified cell for all numeric values.
+ * Handles both regular numbers and big numbers (bigint/bigdecimal).
+ */
 export declare class NumberCell extends CellBase {
     readonly cell: Malloy.CellWithNumberCell;
     readonly field: NumberField;
     readonly parent: NestCell | undefined;
     constructor(cell: Malloy.CellWithNumberCell, field: NumberField, parent: NestCell | undefined);
-    get value(): number;
     /**
      * Returns the numeric value as a JS number.
-     * For NumberCell, this is the same as `.value`.
+     * May be lossy for bigint/bigdecimal values > 2^53.
      */
-    number(): number;
-    compareTo(other: Cell): 1 | 0 | -1;
-    get literalValue(): Malloy.LiteralValue | undefined;
-}
-export declare class BigNumberCell extends CellBase {
-    readonly cell: Malloy.CellWithBigNumberCell;
-    readonly field: NumberField;
-    readonly parent: NestCell | undefined;
-    constructor(cell: Malloy.CellWithBigNumberCell, field: NumberField, parent: NestCell | undefined);
+    get value(): number;
     /**
-     * Returns the string representation of the big number value.
-     * Use this for display or when precision matters.
+     * Returns the precise string representation for large values.
+     * Undefined for regular numbers that fit in JS number.
      */
-    get value(): string;
+    get stringValue(): string | undefined;
+    /**
+     * Returns the number subtype from the schema.
+     * 'integer' | 'decimal' | 'bigint' | future 'bigdecimal'
+     */
+    get subtype(): Malloy.NumberSubtype | undefined;
     /**
-     * Returns the value as a JS number (potentially lossy for large values).
-     * Use this when a number is required (e.g., for charts, calculations).
+     * Returns true if this value needs string representation for precision.
+     */
+    needsStringPrecision(): boolean;
+    /**
+     * Returns the numeric value as a JS number.
+     * Alias for .value for API consistency.
      */
-    number(): number;
+    numberValue(): number;
     /**
      * Returns the value as a JS BigInt for precise integer arithmetic.
-     * Only valid when subtype is 'bigint'.
+     * Only valid when stringValue is defined and subtype is 'bigint'.
      */
     bigint(): bigint;
     compareTo(other: Cell): 1 | 0 | -1;

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

@@ -1,4 +1,4 @@
-import { Cell, NestCell, RecordCell, ArrayCell, BigNumberCell, BooleanCell, DateCell, JSONCell, NullCell, NumberCell, RepeatedRecordCell, StringCell, TimestampCell, TimeCell, RecordOrRepeatedRecordCell, CellValue } from '.';
+import { Cell, NestCell, RecordCell, ArrayCell, BooleanCell, DateCell, JSONCell, NullCell, NumberCell, RepeatedRecordCell, StringCell, TimestampCell, TimeCell, RecordOrRepeatedRecordCell, CellValue } from '.';
 import { Field } from '../fields';
 import { DrillEntry } from '../types';
 import type * as Malloy from '@malloydata/malloy-interfaces';
@@ -16,7 +16,6 @@ export declare abstract class CellBase {
     isRecordOrRepeatedRecord(): this is RecordOrRepeatedRecordCell;
     isNest(): this is NestCell;
     isNumber(): this is NumberCell;
-    isBigNumber(): this is BigNumberCell;
     isDate(): this is DateCell;
     isTime(): this is TimeCell;
     isJSON(): this is JSONCell;

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

@@ -1,13 +1,13 @@
 import { Field } from '../fields';
 import { ArrayCell, RecordCell, RepeatedRecordCell } from './nest';
-import { BigNumberCell, BooleanCell, DateCell, JSONCell, NullCell, NumberCell, SQLNativeCell, StringCell, TimestampCell } from './atomic';
+import { BooleanCell, DateCell, JSONCell, NullCell, NumberCell, SQLNativeCell, StringCell, TimestampCell } from './atomic';
 import type * as Malloy from '@malloydata/malloy-interfaces';
 export { ArrayCell, RecordCell, RepeatedRecordCell, RootCell } from './nest';
-export { BigNumberCell, BooleanCell, DateCell, JSONCell, NullCell, NumberCell, SQLNativeCell, StringCell, TimestampCell, } from './atomic';
+export { BooleanCell, DateCell, JSONCell, NullCell, NumberCell, SQLNativeCell, StringCell, TimestampCell, } from './atomic';
 export type NestCell = ArrayCell | RecordCell;
 export type RecordOrRepeatedRecordCell = RepeatedRecordCell | RecordCell;
 export type TimeCell = DateCell | TimestampCell;
-export type Cell = ArrayCell | RecordCell | NullCell | NumberCell | BigNumberCell | DateCell | JSONCell | StringCell | TimestampCell | BooleanCell | SQLNativeCell;
+export type Cell = ArrayCell | RecordCell | NullCell | NumberCell | DateCell | JSONCell | StringCell | TimestampCell | BooleanCell | SQLNativeCell;
 export type CellValue = string | number | boolean | Date | Cell[] | Record<string, Cell> | null;
 export declare const Cell: {
     from(cell: Malloy.Cell, field: Field, parent: NestCell): Cell;