@inkindcards/semantic-layer 2.2.6 → 2.4.0

package/dist/components.d.cts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { S as SemanticField, d as FieldType, Q as QueryResult } from './types-c5qj4BKB.cjs';
+import { S as SemanticField, d as FieldType, Q as QueryResult, T as TimeGrain } from './types-c5qj4BKB.cjs';
 import React__default from 'react';
 
 interface MetricPickerProps {
@@ -73,7 +73,7 @@ interface DataInspectorProps {
 }
 /**
  * Dev-mode overlay that wraps your app in an InspectableRegistry and provides
- * a floating toggle + inspector modal for data migration.
+ * a floating toggle + unified modal for data migration and report building.
  * Renders the registry context so <Inspectable> children can register.
  */
 declare function DataInspector({ children }: DataInspectorProps): react_jsx_runtime.JSX.Element;
@@ -84,20 +84,76 @@ interface FieldMatch {
     suggestedField: SemanticField | null;
     confidence: MatchConfidence;
 }
+interface ChartAnalysis {
+    dimensionColumns: string[];
+    metricColumns: string[];
+}
+/**
+ * Best-effort match of a single column name against the catalog.
+ */
+declare function matchField(column: string, catalog: SemanticField[]): {
+    field: SemanticField | null;
+    confidence: MatchConfidence;
+};
 /**
  * Match an array of column names against the semantic layer field catalog.
  * Uses three layers: exact name match, normalized match, then display name match.
  */
 declare function matchFields(columns: string[], catalog: SemanticField[]): FieldMatch[];
+/**
+ * Analyze chart data to classify columns as dimensions (string/date values)
+ * or metrics (numeric values). Used by the inspector modal to build the
+ * query builder UI instead of a flat column-to-field mapping.
+ */
+declare function analyzeChartData(columns: string[], sampleValues: Record<string, unknown>[]): ChartAnalysis;
 
 interface FieldMapping {
     column: string;
     field: SemanticField | null;
 }
+interface DimensionMapping {
+    column: string;
+    field: SemanticField;
+}
+interface MigrationConfig {
+    componentLabel: string;
+    dimensions: DimensionMapping[];
+    metrics: SemanticField[];
+    grain: TimeGrain | null;
+    originalMetricColumns: string[];
+}
 /**
  * Generate a ready-to-paste Lovable prompt that tells the AI how to migrate
- * a component from its current data to a useSemanticQuery() call.
+ * a component from hardcoded data to a useSemanticQuery() call.
+ *
+ * Understands the distinction between dimensions (groupBy) and metrics (values),
+ * and produces correct query config with data reshaping instructions.
  */
-declare function generateMigrationPrompt(componentLabel: string, mappings: FieldMapping[]): string;
+declare function generateMigrationPrompt(config: MigrationConfig): string;
+
+type WidgetType = "line" | "bar" | "area" | "pie" | "table" | "kpi";
+type DashboardLayout = "single" | "two-column" | "dashboard";
+interface WidgetConfig {
+    id: string;
+    title: string;
+    type: WidgetType;
+    metrics: SemanticField[];
+    groupBy: SemanticField[];
+    grain: TimeGrain | null;
+    comparisonMetric?: SemanticField;
+}
+interface SharedFilter {
+    dimension: SemanticField;
+    label: string;
+}
+interface ReportConfig {
+    dashboardTitle: string;
+    layout: DashboardLayout;
+    widgets: WidgetConfig[];
+    sharedFilters: SharedFilter[];
+}
+declare function generateReportPrompt(config: ReportConfig): string;
+declare function canOpenInLovable(prompt: string): boolean;
+declare function openInLovable(prompt: string): void;
 
-export { AdminDashboard, type AdminDashboardProps, DataCatalog, type DataCatalogProps, DataInspector, type DataInspectorProps, type FieldMapping, type FieldMatch, Inspectable, type InspectableProps, type MatchConfidence, MetricPicker, type MetricPickerProps, ResultsTable, type ResultsTableProps, generateMigrationPrompt, matchFields };
+export { AdminDashboard, type AdminDashboardProps, type ChartAnalysis, type DashboardLayout, DataCatalog, type DataCatalogProps, DataInspector, type DataInspectorProps, type DimensionMapping, type FieldMapping, type FieldMatch, Inspectable, type InspectableProps, type MatchConfidence, MetricPicker, type MetricPickerProps, type MigrationConfig, type ReportConfig, ResultsTable, type ResultsTableProps, type SharedFilter, type WidgetConfig, type WidgetType, analyzeChartData, canOpenInLovable, generateMigrationPrompt, generateReportPrompt, matchField, matchFields, openInLovable };

package/dist/components.d.ts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { S as SemanticField, d as FieldType, Q as QueryResult } from './types-c5qj4BKB.js';
+import { S as SemanticField, d as FieldType, Q as QueryResult, T as TimeGrain } from './types-c5qj4BKB.js';
 import React__default from 'react';
 
 interface MetricPickerProps {
@@ -73,7 +73,7 @@ interface DataInspectorProps {
 }
 /**
  * Dev-mode overlay that wraps your app in an InspectableRegistry and provides
- * a floating toggle + inspector modal for data migration.
+ * a floating toggle + unified modal for data migration and report building.
  * Renders the registry context so <Inspectable> children can register.
  */
 declare function DataInspector({ children }: DataInspectorProps): react_jsx_runtime.JSX.Element;
@@ -84,20 +84,76 @@ interface FieldMatch {
     suggestedField: SemanticField | null;
     confidence: MatchConfidence;
 }
+interface ChartAnalysis {
+    dimensionColumns: string[];
+    metricColumns: string[];
+}
+/**
+ * Best-effort match of a single column name against the catalog.
+ */
+declare function matchField(column: string, catalog: SemanticField[]): {
+    field: SemanticField | null;
+    confidence: MatchConfidence;
+};
 /**
  * Match an array of column names against the semantic layer field catalog.
  * Uses three layers: exact name match, normalized match, then display name match.
  */
 declare function matchFields(columns: string[], catalog: SemanticField[]): FieldMatch[];
+/**
+ * Analyze chart data to classify columns as dimensions (string/date values)
+ * or metrics (numeric values). Used by the inspector modal to build the
+ * query builder UI instead of a flat column-to-field mapping.
+ */
+declare function analyzeChartData(columns: string[], sampleValues: Record<string, unknown>[]): ChartAnalysis;
 
 interface FieldMapping {
     column: string;
     field: SemanticField | null;
 }
+interface DimensionMapping {
+    column: string;
+    field: SemanticField;
+}
+interface MigrationConfig {
+    componentLabel: string;
+    dimensions: DimensionMapping[];
+    metrics: SemanticField[];
+    grain: TimeGrain | null;
+    originalMetricColumns: string[];
+}
 /**
  * Generate a ready-to-paste Lovable prompt that tells the AI how to migrate
- * a component from its current data to a useSemanticQuery() call.
+ * a component from hardcoded data to a useSemanticQuery() call.
+ *
+ * Understands the distinction between dimensions (groupBy) and metrics (values),
+ * and produces correct query config with data reshaping instructions.
  */
-declare function generateMigrationPrompt(componentLabel: string, mappings: FieldMapping[]): string;
+declare function generateMigrationPrompt(config: MigrationConfig): string;
+
+type WidgetType = "line" | "bar" | "area" | "pie" | "table" | "kpi";
+type DashboardLayout = "single" | "two-column" | "dashboard";
+interface WidgetConfig {
+    id: string;
+    title: string;
+    type: WidgetType;
+    metrics: SemanticField[];
+    groupBy: SemanticField[];
+    grain: TimeGrain | null;
+    comparisonMetric?: SemanticField;
+}
+interface SharedFilter {
+    dimension: SemanticField;
+    label: string;
+}
+interface ReportConfig {
+    dashboardTitle: string;
+    layout: DashboardLayout;
+    widgets: WidgetConfig[];
+    sharedFilters: SharedFilter[];
+}
+declare function generateReportPrompt(config: ReportConfig): string;
+declare function canOpenInLovable(prompt: string): boolean;
+declare function openInLovable(prompt: string): void;
 
-export { AdminDashboard, type AdminDashboardProps, DataCatalog, type DataCatalogProps, DataInspector, type DataInspectorProps, type FieldMapping, type FieldMatch, Inspectable, type InspectableProps, type MatchConfidence, MetricPicker, type MetricPickerProps, ResultsTable, type ResultsTableProps, generateMigrationPrompt, matchFields };
+export { AdminDashboard, type AdminDashboardProps, type ChartAnalysis, type DashboardLayout, DataCatalog, type DataCatalogProps, DataInspector, type DataInspectorProps, type DimensionMapping, type FieldMapping, type FieldMatch, Inspectable, type InspectableProps, type MatchConfidence, MetricPicker, type MetricPickerProps, type MigrationConfig, type ReportConfig, ResultsTable, type ResultsTableProps, type SharedFilter, type WidgetConfig, type WidgetType, analyzeChartData, canOpenInLovable, generateMigrationPrompt, generateReportPrompt, matchField, matchFields, openInLovable };