@malloy-publisher/sdk 0.0.145 → 0.0.147

package/README.md

@@ -634,6 +634,29 @@ source: recalls is duckdb.table('data/recalls.csv') extend {
 }
 ```
 
+### Custom Labels
+
+By default, filters display the dimension field name in the UI. You can customize the display label using the `# label="..."` annotation:
+
+```malloy
+source: recalls is duckdb.table('data/recalls.csv') extend {
+  dimension:
+    #(filter) {"type": "Star"}
+    # label="Vehicle Manufacturer"
+    Manufacturer is Manufacturer_old
+
+    #(filter) {"type": "Retrieval"}
+    # label="Recall Subject"
+    Subject is Subject_old
+
+    #(filter) {"type": "MinMax"}
+    # label="Number of Affected Vehicles"
+    potentially_affected is affected_count
+}
+```
+
+The `# label="..."` annotation can be placed before or after the `#(filter)` annotation. When present, the label value will be displayed in the filter UI instead of the raw field name.
+
 ### Notebook Annotation Syntax
 
 Enable filters in a notebook by adding a `##(filters)` annotation in a Malloy code cell. This annotation specifies which dimensions should appear as filters using `source.dimension` format:
@@ -665,9 +688,9 @@ const config: DimensionFiltersConfig = {
   package: "faa",
   indexLimit: 1000,
   dimensionSpecs: [
-    { dimensionName: "origin_code", filterType: "Star", source: "flights", model: "flights.malloy" },
-    { dimensionName: "distance", filterType: "MinMax", source: "flights", model: "flights.malloy" },
-    { dimensionName: "dep_time", filterType: "DateMinMax", source: "flights", model: "flights.malloy" },
+    { dimensionName: "origin_code", filterType: "Star", source: "flights", model: "flights.malloy", label: "Origin Airport" },
+    { dimensionName: "distance", filterType: "MinMax", source: "flights", model: "flights.malloy", label: "Distance (miles)" },
+    { dimensionName: "dep_time", filterType: "DateMinMax", source: "flights", model: "flights.malloy", label: "Departure Time" },
   ],
 };
 

package/dist/components/RenderedResult/ResultContainer.d.ts

@@ -5,5 +5,5 @@ interface ResultContainerProps {
     hideToggle?: boolean;
     maxResultSize?: number;
 }
-export default function ResultContainer({ result, minHeight, maxHeight, hideToggle, maxResultSize, }: ResultContainerProps): import("react/jsx-runtime").JSX.Element;
+export default function ResultContainer({ result, minHeight, maxHeight, hideToggle: _hideToggle, maxResultSize, }: ResultContainerProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/filter/utils.d.ts

@@ -37,6 +37,11 @@ export declare function parseNotebookFilterAnnotation(annotations: string[] | un
  * Returns the filter annotation or null if not found
  */
 export declare function parseDimensionFilterAnnotation(annotation: string): DimensionFilterAnnotation | null;
+/**
+ * Parse # label="..." annotation from a dimension annotation string
+ * Returns the label value or null if not found
+ */
+export declare function parseLabelAnnotation(annotation: string): string | null;
 /**
  * Parse all source infos from notebook cells and create a map of source_name -> SourceInfo
  * Also returns the model path from the first import statement found

package/dist/hooks/useDimensionalFilterRangeData.d.ts

@@ -15,6 +15,8 @@ export interface DimensionSpec {
     source: string;
     /** Model path */
     model: string;
+    /** Label to display in the UI (derived from # label="..." annotation) */
+    label?: string;
     /** Minimum similarity score for Retrieval filter type (default: 0.1) */
     minSimilarityScore?: number;
     /** Optional list of static values to use for the dropdown instead of querying */