@malloydata/render 0.0.353 → 0.0.355

package/.storybook/malloy-stories-indexer.ts

@@ -187,8 +187,9 @@ export function viteMalloyStoriesPlugin(): PluginOption {
               console.log('initial state', metadata);
               console.log('render properties', metadata.getFieldEntry(metadata.rootField.key).renderProperties);
               const plugin = viz.getActivePlugin(metadata.rootField.key);
-              console.log('plugin', plugin, plugin?.getSettings());
-              const tag = plugin?.settingsToTag(plugin?.getSettings());
+              const isCoreViz = plugin && 'getSettings' in plugin;
+              console.log('plugin', plugin, isCoreViz ? plugin.getSettings() : undefined);
+              const tag = isCoreViz ? plugin.settingsToTag(plugin.getSettings()) : undefined;
               console.log('tag', tag, tag?.toString());
               console.groupEnd();
               viz.render(targetElement);

package/dist/module/component/cell-utils.d.ts

@@ -1,5 +1,5 @@
 import { Cell } from '../data_tree';
-import { Tag } from '@malloydata/malloy-tag';
+import { CellFormatConfig } from './tag-configs';
 export interface RenderCellValueOptions {
     /**
      * Value to return for null cells.
@@ -7,12 +7,13 @@ export interface RenderCellValueOptions {
      */
     nullValue?: string;
     /**
-     * Override tag for formatting.
-     * Use this when rendering array elements - pass the array field's tag
-     * so formatting (currency, percent, etc.) is applied from the array definition.
-     * If not provided, uses the cell's own field tag.
+     * Override format config.
+     * Use this when rendering array elements - pass the array field's
+     * pre-resolved config so formatting (currency, percent, etc.) is
+     * applied from the array definition.
+     * If not provided, uses the cell's own field's tag config.
      */
-    tag?: Tag;
+    config?: CellFormatConfig;
 }
 /**
  * Render a Cell value to a formatted display string.
@@ -30,8 +31,8 @@ export interface RenderCellValueOptions {
  * renderCellValue(cell)
  *
  * @example
- * // Array elements - use array field's tag for formatting
- * renderCellValue(elementCell, { tag: arrayField.tag })
+ * // Array elements - use array field's config for formatting
+ * renderCellValue(elementCell, { config: arrayField.getTagConfig() })
  *
  * @example
  * // Custom null display

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

@@ -1,8 +1,8 @@
 import { RenderTimeStringOptions } from '../util';
 import { Field, NumberCell } from '../data_tree';
-import { Tag } from '@malloydata/malloy-tag';
+import { CellFormatConfig } from './tag-configs';
 /**
- * Renders a numeric field with formatting based on tags.
+ * Renders a numeric field with formatting based on pre-resolved tag config.
  *
  * Supports:
  * - Currency shorthand: # currency=usd2m, # currency=eur0k
@@ -11,33 +11,19 @@ import { Tag } from '@malloydata/malloy-tag';
  * - Number verbose: # number { scale=m decimals=2 suffix=word }
  * - Legacy: # number=big, # currency=euro
  */
-export declare function renderNumericField(f: Field, value: number | null | undefined, tagOverride?: Tag): string;
+export declare function renderNumericField(f: Field, value: number | null | undefined, configOverride?: CellFormatConfig): 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, scale, and custom number formats are lossy for values > 2^53
- * because they require numeric operations. This is acceptable for abbreviated display.
  */
-export declare function renderBigNumberField(f: Field, value: string | null | undefined, tagOverride?: Tag): string;
+export declare function renderBigNumberField(f: Field, value: string | null | undefined, configOverride?: CellFormatConfig): 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
- * @param tagOverride - Optional tag to use for formatting (e.g., for array elements, use the array field's tag)
- * @returns Formatted string for display, respecting field tags (currency, percent, etc.)
+ * @param configOverride - Optional config override (e.g., for array elements, use the array field's config)
  */
-export declare function renderNumberCell(cell: NumberCell, tagOverride?: Tag): string;
-export declare function renderDateTimeField(f: Field, value: Date | null | undefined, options?: RenderTimeStringOptions, tagOverride?: Tag): string;
+export declare function renderNumberCell(cell: NumberCell, configOverride?: CellFormatConfig): string;
+export declare function renderDateTimeField(f: Field, value: Date | null | undefined, options?: RenderTimeStringOptions, configOverride?: CellFormatConfig): string;

package/dist/module/component/table/pivot-utils.d.ts

@@ -119,7 +119,7 @@ export declare function getPivotDimensionValue(pivotedField: PivotedField, dimen
  */
 export declare function shouldPivot(field: Field): boolean;
 /**
- * Gets user-defined pivot dimensions from the tag.
+ * Gets user-defined pivot dimensions from the pre-resolved tag config.
  * Syntax: # pivot { dimensions=[d1, d2] }
  */
 export declare function getUserDefinedDimensions(field: Field): string[] | undefined;

package/dist/module/component/tag-configs.d.ts

@@ -0,0 +1,76 @@
+import { Field } from '../data_tree';
+import { ScaleKey, SuffixFormatKey } from '../util';
+export interface ImageTagConfig {
+    width?: string;
+    height?: string;
+    alt?: string;
+    altField?: string;
+}
+export declare function resolveImageTags(field: Field): ImageTagConfig;
+export interface LinkTagConfig {
+    linkField?: string;
+    urlTemplate?: string;
+}
+export declare function resolveLinkTags(field: Field): LinkTagConfig;
+export interface ListTagConfig {
+    isListDetail: boolean;
+}
+export declare function resolveListTags(field: Field): ListTagConfig;
+export interface CurrencyConfig {
+    symbol: string;
+    scale?: ScaleKey | 'auto';
+    decimals?: number;
+    suffixFormat: SuffixFormatKey;
+}
+export interface NumberConfig {
+    formatString?: string;
+    scale?: ScaleKey | 'auto';
+    decimals?: number;
+    suffixFormat?: SuffixFormatKey;
+    isId?: boolean;
+    isBig?: boolean;
+}
+export interface DurationConfig {
+    unit: string;
+    terse: boolean;
+}
+export type CellFormatConfig = {
+    mode: 'currency';
+    currency: CurrencyConfig;
+} | {
+    mode: 'percent';
+} | {
+    mode: 'duration';
+    duration: DurationConfig;
+} | {
+    mode: 'number';
+    number: NumberConfig;
+} | {
+    mode: 'dateFormat';
+    formatString: string;
+} | {
+    mode: 'default';
+};
+export declare function resolveCellFormatTags(field: Field): CellFormatConfig;
+export interface ColumnTagConfig {
+    width: number | null;
+    height: number | null;
+    wordBreak: boolean;
+}
+export interface TableNestConfig {
+    fillSize: boolean;
+    transposeLimit?: number;
+    pivotDimensions?: string[];
+}
+export interface DashboardNestConfig {
+    maxTableHeight: number | null;
+}
+/**
+ * Run the appropriate tag resolver for a field based on its renderAs type
+ * and store the result on the field. Called during registerFields().
+ *
+ * Also resolves cross-cutting tag properties (label, column, tooltip, break)
+ * for ALL fields, ensuring all tag access happens at setup time.
+ * Components use the resolved configs instead of reading tags directly.
+ */
+export declare function resolveBuiltInTags(field: Field): void;

package/dist/module/component/types.d.ts

@@ -5,7 +5,6 @@ import { Cell, DrillEntry, Field, RecordCell, RepeatedRecordCell } from '../data
 import type * as Malloy from '@malloydata/malloy-interfaces';
 export type RendererProps = {
     dataColumn: Cell;
-    tag: Tag;
     customProps?: Record<string, Record<string, unknown>>;
 };
 export type VegaSignalRef = {

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

@@ -11,8 +11,35 @@ export declare abstract class FieldBase {
     readonly valueSet: Set<string | number | boolean>;
     protected plugins: RenderPluginInstance[];
     protected _renderAs: string;
+    private _tagConfig;
+    private _resolvedLabel;
+    private _columnConfig;
     getPlugins(): RenderPluginInstance[];
     setPlugins(plugins: RenderPluginInstance[]): void;
+    /**
+     * Get the pre-resolved tag configuration for this field.
+     * Tag configs are extracted at setup time (during setResult)
+     * so components never need to read tags at render time.
+     */
+    getTagConfig<T>(): T | undefined;
+    /**
+     * Store pre-resolved tag configuration on this field.
+     * Called during registerFields() for built-in renderers.
+     */
+    setTagConfig(config: unknown): void;
+    /**
+     * Get the resolved display label for this field.
+     * Returns the custom label from # label tag if set, otherwise the field name.
+     * Resolved at setup time so components never read the label tag.
+     */
+    getLabel(): string;
+    setResolvedLabel(label: string | undefined): void;
+    /**
+     * Get the pre-resolved column configuration for this field.
+     * Column configs are extracted at setup time (width, height, word_break).
+     */
+    getColumnConfig<T>(): T | undefined;
+    setColumnConfig(config: unknown): void;
     renderAs(): string;
     constructor(field: Malloy.DimensionInfo, parent: Field | undefined, 
     /**

package/dist/module/html/main_renderer_factory.d.ts

@@ -29,7 +29,7 @@ import { NumberRendererFactory } from './number';
 import { UnsupportedRendererFactory } from './unsupported';
 import { TextRendererFactory } from './text';
 export declare class MainRendererFactory {
-    static renderFactories: (VegaRendererFactory | LineChartRendererFactory | ScatterChartRendererFactory | ShapeMapRendererFactory | SegmentMapRendererFactory | JSONRendererFactory | TextRendererFactory | NumberRendererFactory | PointMapRendererFactory | ImageRendererFactory | BarChartRendererFactory | ColumnSparkLineRendererFactory | BarSparkLineRendererFactory | SparkLineRendererFactory | AreaSparkLineRendererFactory | DateRendererFactory | CurrencyRendererFactory | PercentRendererFactory | DataVolumeRendererFactory | BytesRendererFactory | LinkRendererFactory | DurationRendererFactory | BooleanRendererFactory | UnsupportedRendererFactory)[];
+    static renderFactories: (JSONRendererFactory | TextRendererFactory | NumberRendererFactory | ShapeMapRendererFactory | PointMapRendererFactory | SegmentMapRendererFactory | VegaRendererFactory | ScatterChartRendererFactory | ImageRendererFactory | LineChartRendererFactory | BarChartRendererFactory | ColumnSparkLineRendererFactory | BarSparkLineRendererFactory | SparkLineRendererFactory | AreaSparkLineRendererFactory | DateRendererFactory | CurrencyRendererFactory | PercentRendererFactory | DataVolumeRendererFactory | BytesRendererFactory | LinkRendererFactory | DurationRendererFactory | BooleanRendererFactory | UnsupportedRendererFactory)[];
     create(renderDef: RenderDef | undefined, tagged: Tag, document: Document, styleDefaults: StyleDefaults, rendererOptions: RendererOptions, field: Field, timezone?: string | undefined): Renderer | undefined;
     matchesRenderDef(renderDef: RenderDef | undefined, factory: RendererFactory<DataRenderOptions>): boolean | "" | undefined;
     matchesTag(tagged: Tag, factory: RendererFactory<DataRenderOptions>): boolean | "" | undefined;