@prismiq/react 0.1.0

package/dist/utils/index.d.cts

@@ -0,0 +1,112 @@
+export { A as ArrowNavigationOptions, F as FocusTrapOptions, S as SkipLinkProps, g as UseArrowNavigationResult, U as UseFocusTrapResult, d as announceToScreenReader, f as focusVisibleStyles, e as skipLinkFocusStyles, s as skipLinkStyles, a as useArrowNavigation, u as useFocusTrap, c as useFocusVisible, b as useRovingTabIndex } from '../accessibility-2yy5yqRR.cjs';
+import { Q as QueryResult } from '../types-WrCbOeAV.cjs';
+import 'react';
+
+/**
+ * Date formatting utilities for converting .NET format strings to JavaScript date formatters.
+ *
+ * Supports common .NET date format patterns used by RevealBI.
+ */
+/**
+ * Convert .NET date format string to JavaScript date formatter.
+ *
+ * Common patterns:
+ * - dd-MMM-yyyy HH:mm -> 20-Mar-2025 17:00
+ * - yyyy-MM-dd -> 2025-03-20
+ * - MM/dd/yyyy -> 03/20/2025
+ * - yyyy-MM-dd HH:mm:ss -> 2025-03-20 17:00:00
+ *
+ * @param formatString .NET date format string
+ * @returns Formatter function
+ */
+declare function createDateFormatter(formatString: string): (value: unknown) => string;
+/**
+ * Create date formatters from config map.
+ *
+ * @param dateFormats Map of column name to .NET format string
+ * @returns Map of column name to formatter function
+ */
+declare function createDateFormatters(dateFormats: Record<string, string>): Record<string, (value: unknown) => string>;
+/**
+ * Format a Unix timestamp as relative time (e.g., "5 min ago").
+ *
+ * @param timestamp Unix timestamp in seconds
+ * @returns Relative time string
+ */
+declare function formatRelativeTime(timestamp: number | null | undefined): string;
+
+/**
+ * Pivot utility for transforming query results from long format to wide format.
+ */
+
+interface PivotConfig {
+    /** Column whose unique values become new columns. */
+    pivotColumn: string;
+    /** Column containing values to distribute across pivot columns. */
+    valueColumn: string;
+    /** Columns to keep as-is (dimension/grouping columns). */
+    dimensionColumns: string[];
+}
+/**
+ * Pivot a query result by transforming unique values in pivotColumn
+ * into separate columns.
+ *
+ * Example:
+ * Input (long format):
+ *   account | date       | name | value
+ *   Cerby   | 2025-02-01 | MAU  | 9
+ *   Cerby   | 2025-02-01 | Searches | 1
+ *
+ * Output (wide format):
+ *   account | date       | MAU | Searches
+ *   Cerby   | 2025-02-01 | 9   | 1
+ *
+ * @param result - The query result to pivot
+ * @param config - Pivot configuration
+ * @returns Pivoted query result
+ */
+declare function pivotQueryResult(result: QueryResult, config: PivotConfig): QueryResult;
+
+/**
+ * Utilities for parsing column references in "tableId.column" format.
+ */
+/**
+ * Parsed column reference with table ID and column name.
+ */
+interface ColumnReference {
+    tableId: string;
+    column: string;
+}
+/**
+ * Parse a column reference in "tableId.column" format.
+ *
+ * @param ref - The column reference string (e.g., "t1.created_at")
+ * @param defaultTableId - Table ID to use when ref has no table prefix
+ * @returns Parsed reference, or null if invalid. Logs a warning only for
+ *          malformed references (e.g., "table." or ".column" or "a.b.c").
+ *          Empty/whitespace inputs return null without warning.
+ */
+declare function parseColumnRef(ref: string, defaultTableId: string): ColumnReference | null;
+
+/**
+ * Safe markdown parser that escapes HTML to prevent XSS attacks.
+ *
+ * Supports a limited subset of markdown:
+ * - Headings (#, ##, ###)
+ * - Bold (**text**)
+ * - Italic (*text*)
+ * - Inline code (`code`)
+ * - Line breaks
+ */
+/**
+ * Parse markdown text into safe HTML.
+ *
+ * HTML is escaped first to prevent XSS, then markdown syntax is converted.
+ *
+ * @param text - Raw markdown text
+ * @param codeStyle - Optional inline styles for code blocks
+ * @returns Safe HTML string
+ */
+declare function parseMarkdownSafe(text: string, codeStyle?: string): string;
+
+export { type ColumnReference, type PivotConfig, createDateFormatter, createDateFormatters, formatRelativeTime, parseColumnRef, parseMarkdownSafe, pivotQueryResult };

package/dist/utils/index.d.ts

@@ -0,0 +1,112 @@
+export { A as ArrowNavigationOptions, F as FocusTrapOptions, S as SkipLinkProps, g as UseArrowNavigationResult, U as UseFocusTrapResult, d as announceToScreenReader, f as focusVisibleStyles, e as skipLinkFocusStyles, s as skipLinkStyles, a as useArrowNavigation, u as useFocusTrap, c as useFocusVisible, b as useRovingTabIndex } from '../accessibility-2yy5yqRR.js';
+import { Q as QueryResult } from '../types-WrCbOeAV.js';
+import 'react';
+
+/**
+ * Date formatting utilities for converting .NET format strings to JavaScript date formatters.
+ *
+ * Supports common .NET date format patterns used by RevealBI.
+ */
+/**
+ * Convert .NET date format string to JavaScript date formatter.
+ *
+ * Common patterns:
+ * - dd-MMM-yyyy HH:mm -> 20-Mar-2025 17:00
+ * - yyyy-MM-dd -> 2025-03-20
+ * - MM/dd/yyyy -> 03/20/2025
+ * - yyyy-MM-dd HH:mm:ss -> 2025-03-20 17:00:00
+ *
+ * @param formatString .NET date format string
+ * @returns Formatter function
+ */
+declare function createDateFormatter(formatString: string): (value: unknown) => string;
+/**
+ * Create date formatters from config map.
+ *
+ * @param dateFormats Map of column name to .NET format string
+ * @returns Map of column name to formatter function
+ */
+declare function createDateFormatters(dateFormats: Record<string, string>): Record<string, (value: unknown) => string>;
+/**
+ * Format a Unix timestamp as relative time (e.g., "5 min ago").
+ *
+ * @param timestamp Unix timestamp in seconds
+ * @returns Relative time string
+ */
+declare function formatRelativeTime(timestamp: number | null | undefined): string;
+
+/**
+ * Pivot utility for transforming query results from long format to wide format.
+ */
+
+interface PivotConfig {
+    /** Column whose unique values become new columns. */
+    pivotColumn: string;
+    /** Column containing values to distribute across pivot columns. */
+    valueColumn: string;
+    /** Columns to keep as-is (dimension/grouping columns). */
+    dimensionColumns: string[];
+}
+/**
+ * Pivot a query result by transforming unique values in pivotColumn
+ * into separate columns.
+ *
+ * Example:
+ * Input (long format):
+ *   account | date       | name | value
+ *   Cerby   | 2025-02-01 | MAU  | 9
+ *   Cerby   | 2025-02-01 | Searches | 1
+ *
+ * Output (wide format):
+ *   account | date       | MAU | Searches
+ *   Cerby   | 2025-02-01 | 9   | 1
+ *
+ * @param result - The query result to pivot
+ * @param config - Pivot configuration
+ * @returns Pivoted query result
+ */
+declare function pivotQueryResult(result: QueryResult, config: PivotConfig): QueryResult;
+
+/**
+ * Utilities for parsing column references in "tableId.column" format.
+ */
+/**
+ * Parsed column reference with table ID and column name.
+ */
+interface ColumnReference {
+    tableId: string;
+    column: string;
+}
+/**
+ * Parse a column reference in "tableId.column" format.
+ *
+ * @param ref - The column reference string (e.g., "t1.created_at")
+ * @param defaultTableId - Table ID to use when ref has no table prefix
+ * @returns Parsed reference, or null if invalid. Logs a warning only for
+ *          malformed references (e.g., "table." or ".column" or "a.b.c").
+ *          Empty/whitespace inputs return null without warning.
+ */
+declare function parseColumnRef(ref: string, defaultTableId: string): ColumnReference | null;
+
+/**
+ * Safe markdown parser that escapes HTML to prevent XSS attacks.
+ *
+ * Supports a limited subset of markdown:
+ * - Headings (#, ##, ###)
+ * - Bold (**text**)
+ * - Italic (*text*)
+ * - Inline code (`code`)
+ * - Line breaks
+ */
+/**
+ * Parse markdown text into safe HTML.
+ *
+ * HTML is escaped first to prevent XSS, then markdown syntax is converted.
+ *
+ * @param text - Raw markdown text
+ * @param codeStyle - Optional inline styles for code blocks
+ * @returns Safe HTML string
+ */
+declare function parseMarkdownSafe(text: string, codeStyle?: string): string;
+
+export { type ColumnReference, type PivotConfig, createDateFormatter, createDateFormatters, formatRelativeTime, parseColumnRef, parseMarkdownSafe, pivotQueryResult };

package/dist/utils/index.js

@@ -0,0 +1,3 @@
+export { announceToScreenReader, createDateFormatter, createDateFormatters, focusVisibleStyles, formatRelativeTime, parseColumnRef, parseMarkdownSafe, pivotQueryResult, skipLinkFocusStyles, skipLinkStyles, useArrowNavigation, useFocusTrap, useFocusVisible, useRovingTabIndex } from '../chunk-EX74SI67.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/package.json

@@ -0,0 +1,110 @@
+{
+  "name": "@prismiq/react",
+  "version": "0.1.0",
+  "description": "React SDK for Prismiq embedded analytics",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./charts": {
+      "types": "./dist/charts/index.d.ts",
+      "import": "./dist/charts/index.js",
+      "require": "./dist/charts/index.cjs"
+    },
+    "./dashboard": {
+      "types": "./dist/dashboard/index.d.ts",
+      "import": "./dist/dashboard/index.js",
+      "require": "./dist/dashboard/index.cjs"
+    },
+    "./components": {
+      "types": "./dist/components/index.d.ts",
+      "import": "./dist/components/index.js",
+      "require": "./dist/components/index.cjs"
+    },
+    "./export": {
+      "types": "./dist/export/index.d.ts",
+      "import": "./dist/export/index.js",
+      "require": "./dist/export/index.cjs"
+    },
+    "./ssr": {
+      "types": "./dist/ssr/index.d.ts",
+      "import": "./dist/ssr/index.js",
+      "require": "./dist/ssr/index.cjs"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.js",
+      "require": "./dist/utils/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts,.tsx",
+    "clean": "rm -rf dist",
+    "size": "tsup && du -sh dist/*",
+    "prepublishOnly": "npm run typecheck && npm run build"
+  },
+  "peerDependencies": {
+    "echarts": "^5.4.0 || ^6.0.0",
+    "echarts-for-react": "^3.0.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-grid-layout": "^1.4.0 || ^2.0.0",
+    "xlsx": "^0.18.0"
+  },
+  "peerDependenciesMeta": {
+    "echarts": {
+      "optional": true
+    },
+    "echarts-for-react": {
+      "optional": true
+    },
+    "react-grid-layout": {
+      "optional": true
+    },
+    "xlsx": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.3.7",
+    "@types/react-grid-layout": "^1.3.6",
+    "echarts": "^6.0.0",
+    "echarts-for-react": "^3.0.5",
+    "react": "^18.2.0",
+    "react-grid-layout": "^2.1.1",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "xlsx": "^0.18.5"
+  },
+  "keywords": [
+    "react",
+    "analytics",
+    "dashboard",
+    "embedded",
+    "postgresql",
+    "visualization",
+    "charts",
+    "echarts",
+    "query-builder"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/prismiq/prismiq.git",
+    "directory": "packages/react"
+  }
+}