@constela/core 0.18.2 → 0.18.4

package/dist/index.d.ts

@@ -2438,4 +2438,79 @@ declare function isSuspenseBoundary(value: unknown): value is SuspenseBoundary;
  */
 declare function isStreamChunk(value: unknown): value is StreamChunk;
 
-export { AI_OUTPUT_TYPES, AI_PROVIDER_TYPES, type ActionDefinition, type ActionStep, type AiDataSource, type AiOutputType, type AiProviderType, type ArrayExpr, BINARY_OPERATORS, type BinExpr, type BinaryOperator, type BindStep, type BooleanField, CLIPBOARD_OPERATIONS, COLOR_SCHEMES, type CallExpr, type CallStep, type ClearTimerStep, type ClipboardOperation, type ClipboardStep, type CloseStep, type CodeNode, type ColorScheme, type ComponentDef, type ComponentNode, type ComponentsRef, type CompoundVariant, type ConcatExpr, type CondExpr, type ConfirmStep, type ConstelaAst, ConstelaError, type ConstelaProgram, type CookieInitialExpr, DATA_SOURCE_TYPES, DATA_TRANSFORMS, type DataExpr, type DataSource, type DataSourceType, type DataTransform, type DelayStep, type DisposeStep, type DomStep, type EachNode, type ElementNode, type ErrorBoundaryNode, type ErrorCode, type ErrorOptions, type EventHandler, type EventHandlerOptions, type Expression, FOCUS_OPERATIONS, type FetchStep, type FlushStrategy, type FocusOperation, type FocusStep, type GenerateStep, type GetExpr, HTTP_METHODS, type HttpMethod, ISLAND_STRATEGIES, type IfNode, type IfStep, type ImportExpr, type ImportStep, type IndexExpr, type IntervalStep, type IslandNode, type IslandStrategy, type IslandStrategyOptions, type LambdaExpr, type LayoutProgram, type LifecycleHooks, type ListField, type LitExpr, type LocalActionDefinition, type LocalActionStep, type LocalExpr, type MarkdownNode, NAVIGATE_TARGETS, type NavigateStep, type NavigateTarget, type NotExpr, type NumberField, type ObjExpr, type ObjectField, type OptimisticStep, PARAM_TYPES, type ParamDef, type ParamExpr, type ParamType, type PortalNode, type Program, type ReconnectConfig, type RefExpr, type RejectStep, type RouteDefinition, type RouteExpr, type SSECloseStep, type SSEConnectStep, STORAGE_OPERATIONS, STORAGE_TYPES, type SendStep, type SetPathStep, type SetStep, type SlotNode, type StateExpr, type StateField, type StaticPathsDefinition, type StorageOperation, type StorageStep, type StorageType, type StreamChunk, type StreamChunkType, type StreamingRenderOptions, type StringField, type StyleExpr, type StylePreset, type SubscribeStep, type SuspenseBoundary, type SuspenseNode, type TextNode, type ThemeColors, type ThemeConfig, type ThemeFonts, UPDATE_OPERATIONS, type UnbindStep, type UpdateOperation, type UpdateStep, VALIDITY_PROPERTIES, type ValidationFailure, type ValidationResult, type ValidationSuccess, type ValidityExpr, type ValidityProperty, type VarExpr, type ViewNode, astSchema, createClipboardWriteMissingValueError, createComponentCycleError, createComponentNotFoundError, createComponentPropMissingError, createComponentPropTypeError, createCondElseRequiredError, createDataNotDefinedError, createDuplicateActionError, createDuplicateDefaultSlotError, createDuplicateIslandIdError, createDuplicateSlotNameError, createImportsNotDefinedError, createInvalidClipboardOperationError, createInvalidDataSourceError, createInvalidNavigateTargetError, createInvalidSlotNameError, createInvalidStorageOperationError, createInvalidStorageTypeError, createLayoutMissingSlotError, createLayoutNotFoundError, createLocalActionInvalidStepError, createOperationInvalidForTypeError, createOperationMissingFieldError, createOperationUnknownError, createRouteNotDefinedError, createSchemaError, createSlotInLoopError, createStorageSetMissingValueError, createUndefinedActionError, createUndefinedDataError, createUndefinedDataSourceError, createUndefinedImportError, createUndefinedLocalStateError, createUndefinedParamError, createUndefinedRefError, createUndefinedRouteParamError, createUndefinedStateError, createUndefinedStyleError, createUndefinedVarError, createUndefinedVariantError, createUnsupportedVersionError, findSimilarNames, isActionStep, isAiDataSource, isArrayExpr, isBinExpr, isBooleanField, isCallStep, isClipboardStep, isCodeNode, isColorScheme, isComponentNode, isConcatExpr, isCondExpr, isConstelaError, isCookieInitialExpr, isDataExpr, isDataSource, isDisposeStep, isEachNode, isElementNode, isErrorBoundaryNode, isEventHandler, isExpression, isFetchStep, isFocusStep, isGenerateStep, isGetExpr, isIfNode, isImportExpr, isImportStep, isIslandNode, isIslandStrategy, isIslandStrategyOptions, isLayoutProgram, isLifecycleHooks, isListField, isLitExpr, isLocalActionDefinition, isLocalActionStep, isMarkdownNode, isNamedSlotNode, isNavigateStep, isNotExpr, isNumberField, isObjectField, isParamExpr, isPortalNode, isRefExpr, isRouteDefinition, isRouteExpr, isSetPathStep, isSetStep, isSlotNode, isStateExpr, isStateField, isStaticPathsDefinition, isStorageStep, isStreamChunk, isStreamingRenderOptions, isStringField, isStyleExpr, isSubscribeStep, isSuspenseBoundary, isSuspenseNode, isTextNode, isThemeColors, isThemeConfig, isThemeFonts, isUpdateStep, isValidityExpr, isVarExpr, isViewNode, validateAst };
+/**
+ * Chart Helper Functions
+ *
+ * Shared chart helper functions used by both runtime evaluator and SSR renderer.
+ * This module provides coordinate calculation, path generation, and data utilities
+ * for chart rendering.
+ */
+/**
+ * Normalizes a value to 0-1 range
+ *
+ * @param value - The value to normalize
+ * @param min - The minimum value of the range
+ * @param max - The maximum value of the range
+ * @returns Normalized value (0-1), or undefined for invalid input
+ */
+declare function normalizeValue(value: unknown, min: unknown, max: unknown): number | undefined;
+/**
+ * Scales a value from one range to another
+ *
+ * @param value - The value to scale
+ * @param domainMin - Minimum of source range
+ * @param domainMax - Maximum of source range
+ * @param rangeMin - Minimum of target range
+ * @param rangeMax - Maximum of target range
+ * @returns Scaled value, or undefined for invalid input
+ */
+declare function scaleValue(value: unknown, domainMin: unknown, domainMax: unknown, rangeMin: unknown, rangeMax: unknown): number | undefined;
+/**
+ * Finds min and max values in data
+ *
+ * @param data - Array of objects
+ * @param valueKey - Key to use for values
+ * @returns Object with min and max, or undefined for invalid input
+ */
+declare function getChartBounds(data: unknown, valueKey: unknown): {
+    min: number;
+    max: number;
+} | undefined;
+/**
+ * Generates scaled line chart points from data.
+ *
+ * @param data - Array of data objects
+ * @param valueKey - Key to extract values from data
+ * @param width - Chart width
+ * @param height - Chart height
+ * @param padding - Padding around chart area (default: 40)
+ * @returns Array of {x, y} points scaled to fit the chart area
+ */
+declare function getLinePoints(data: unknown, valueKey: unknown, width: unknown, height: unknown, padding?: unknown): Array<{
+    x: number;
+    y: number;
+}> | undefined;
+/**
+ * Generates SVG path string for line chart
+ *
+ * @param points - Array of {x, y} points
+ * @param curved - Whether to use curved lines (Catmull-Rom spline)
+ * @returns SVG path string, or undefined for invalid input
+ */
+declare function getLinePath(points: unknown, curved?: unknown): string | undefined;
+/**
+ * Registry of chart helper functions that can be called from expressions.
+ * This is used by both runtime evaluator and SSR renderer.
+ */
+declare const CHART_HELPERS: Record<string, (...args: unknown[]) => unknown>;
+/**
+ * Calls a chart helper function by name.
+ * Returns undefined if the function is not found.
+ *
+ * @param method - The function name to call
+ * @param args - Arguments to pass to the function
+ * @returns The function result, or undefined if not found
+ */
+declare function callChartHelper(method: string, args: unknown[]): unknown;
+
+export { AI_OUTPUT_TYPES, AI_PROVIDER_TYPES, type ActionDefinition, type ActionStep, type AiDataSource, type AiOutputType, type AiProviderType, type ArrayExpr, BINARY_OPERATORS, type BinExpr, type BinaryOperator, type BindStep, type BooleanField, CHART_HELPERS, CLIPBOARD_OPERATIONS, COLOR_SCHEMES, type CallExpr, type CallStep, type ClearTimerStep, type ClipboardOperation, type ClipboardStep, type CloseStep, type CodeNode, type ColorScheme, type ComponentDef, type ComponentNode, type ComponentsRef, type CompoundVariant, type ConcatExpr, type CondExpr, type ConfirmStep, type ConstelaAst, ConstelaError, type ConstelaProgram, type CookieInitialExpr, DATA_SOURCE_TYPES, DATA_TRANSFORMS, type DataExpr, type DataSource, type DataSourceType, type DataTransform, type DelayStep, type DisposeStep, type DomStep, type EachNode, type ElementNode, type ErrorBoundaryNode, type ErrorCode, type ErrorOptions, type EventHandler, type EventHandlerOptions, type Expression, FOCUS_OPERATIONS, type FetchStep, type FlushStrategy, type FocusOperation, type FocusStep, type GenerateStep, type GetExpr, HTTP_METHODS, type HttpMethod, ISLAND_STRATEGIES, type IfNode, type IfStep, type ImportExpr, type ImportStep, type IndexExpr, type IntervalStep, type IslandNode, type IslandStrategy, type IslandStrategyOptions, type LambdaExpr, type LayoutProgram, type LifecycleHooks, type ListField, type LitExpr, type LocalActionDefinition, type LocalActionStep, type LocalExpr, type MarkdownNode, NAVIGATE_TARGETS, type NavigateStep, type NavigateTarget, type NotExpr, type NumberField, type ObjExpr, type ObjectField, type OptimisticStep, PARAM_TYPES, type ParamDef, type ParamExpr, type ParamType, type PortalNode, type Program, type ReconnectConfig, type RefExpr, type RejectStep, type RouteDefinition, type RouteExpr, type SSECloseStep, type SSEConnectStep, STORAGE_OPERATIONS, STORAGE_TYPES, type SendStep, type SetPathStep, type SetStep, type SlotNode, type StateExpr, type StateField, type StaticPathsDefinition, type StorageOperation, type StorageStep, type StorageType, type StreamChunk, type StreamChunkType, type StreamingRenderOptions, type StringField, type StyleExpr, type StylePreset, type SubscribeStep, type SuspenseBoundary, type SuspenseNode, type TextNode, type ThemeColors, type ThemeConfig, type ThemeFonts, UPDATE_OPERATIONS, type UnbindStep, type UpdateOperation, type UpdateStep, VALIDITY_PROPERTIES, type ValidationFailure, type ValidationResult, type ValidationSuccess, type ValidityExpr, type ValidityProperty, type VarExpr, type ViewNode, astSchema, callChartHelper, createClipboardWriteMissingValueError, createComponentCycleError, createComponentNotFoundError, createComponentPropMissingError, createComponentPropTypeError, createCondElseRequiredError, createDataNotDefinedError, createDuplicateActionError, createDuplicateDefaultSlotError, createDuplicateIslandIdError, createDuplicateSlotNameError, createImportsNotDefinedError, createInvalidClipboardOperationError, createInvalidDataSourceError, createInvalidNavigateTargetError, createInvalidSlotNameError, createInvalidStorageOperationError, createInvalidStorageTypeError, createLayoutMissingSlotError, createLayoutNotFoundError, createLocalActionInvalidStepError, createOperationInvalidForTypeError, createOperationMissingFieldError, createOperationUnknownError, createRouteNotDefinedError, createSchemaError, createSlotInLoopError, createStorageSetMissingValueError, createUndefinedActionError, createUndefinedDataError, createUndefinedDataSourceError, createUndefinedImportError, createUndefinedLocalStateError, createUndefinedParamError, createUndefinedRefError, createUndefinedRouteParamError, createUndefinedStateError, createUndefinedStyleError, createUndefinedVarError, createUndefinedVariantError, createUnsupportedVersionError, findSimilarNames, getChartBounds, getLinePath, getLinePoints, isActionStep, isAiDataSource, isArrayExpr, isBinExpr, isBooleanField, isCallStep, isClipboardStep, isCodeNode, isColorScheme, isComponentNode, isConcatExpr, isCondExpr, isConstelaError, isCookieInitialExpr, isDataExpr, isDataSource, isDisposeStep, isEachNode, isElementNode, isErrorBoundaryNode, isEventHandler, isExpression, isFetchStep, isFocusStep, isGenerateStep, isGetExpr, isIfNode, isImportExpr, isImportStep, isIslandNode, isIslandStrategy, isIslandStrategyOptions, isLayoutProgram, isLifecycleHooks, isListField, isLitExpr, isLocalActionDefinition, isLocalActionStep, isMarkdownNode, isNamedSlotNode, isNavigateStep, isNotExpr, isNumberField, isObjectField, isParamExpr, isPortalNode, isRefExpr, isRouteDefinition, isRouteExpr, isSetPathStep, isSetStep, isSlotNode, isStateExpr, isStateField, isStaticPathsDefinition, isStorageStep, isStreamChunk, isStreamingRenderOptions, isStringField, isStyleExpr, isSubscribeStep, isSuspenseBoundary, isSuspenseNode, isTextNode, isThemeColors, isThemeConfig, isThemeFonts, isUpdateStep, isValidityExpr, isVarExpr, isViewNode, normalizeValue, scaleValue, validateAst };

package/dist/index.js

@@ -2654,10 +2654,137 @@ function isStreamChunk(value) {
   }
   return true;
 }
+
+// src/helpers/chart.ts
+function normalizeValue(value, min, max) {
+  if (typeof value !== "number" || typeof min !== "number" || typeof max !== "number") {
+    return void 0;
+  }
+  if (max === min) {
+    return 0;
+  }
+  return (value - min) / (max - min);
+}
+function scaleValue(value, domainMin, domainMax, rangeMin, rangeMax) {
+  if (typeof value !== "number" || typeof domainMin !== "number" || typeof domainMax !== "number" || typeof rangeMin !== "number" || typeof rangeMax !== "number") {
+    return void 0;
+  }
+  if (domainMax === domainMin) {
+    return rangeMin;
+  }
+  const normalized = (value - domainMin) / (domainMax - domainMin);
+  return rangeMin + normalized * (rangeMax - rangeMin);
+}
+function getChartBounds(data, valueKey) {
+  if (!Array.isArray(data) || data.length === 0) {
+    return void 0;
+  }
+  if (typeof valueKey !== "string") {
+    return void 0;
+  }
+  const values = [];
+  for (const item of data) {
+    if (typeof item !== "object" || item === null) {
+      continue;
+    }
+    const val = item[valueKey];
+    if (typeof val === "number") {
+      values.push(val);
+    }
+  }
+  if (values.length === 0) {
+    return void 0;
+  }
+  return {
+    min: Math.min(...values),
+    max: Math.max(...values)
+  };
+}
+function getLinePoints(data, valueKey, width, height, padding) {
+  if (!Array.isArray(data) || data.length === 0) return void 0;
+  if (typeof valueKey !== "string") return void 0;
+  if (typeof width !== "number" || typeof height !== "number") return void 0;
+  if (width <= 0 || height <= 0) return void 0;
+  const pad = typeof padding === "number" ? padding : 40;
+  if (typeof padding !== "undefined" && typeof padding !== "number") return void 0;
+  const bounds = getChartBounds(data, valueKey);
+  if (!bounds) return void 0;
+  const { min, max } = bounds;
+  const chartWidth = width - pad * 2;
+  const chartHeight = height - pad * 2;
+  return data.map((item, idx) => {
+    const value = item[valueKey];
+    if (typeof value !== "number") return { x: 0, y: 0 };
+    const x = data.length === 1 ? pad : pad + idx / (data.length - 1) * chartWidth;
+    const y = min === max ? pad + chartHeight / 2 : pad + chartHeight - scaleValue(value, min, max, 0, chartHeight);
+    return { x, y };
+  });
+}
+function getCurvedPath(points) {
+  if (points.length < 2) {
+    return points.length === 1 ? `M${points[0].x},${points[0].y}` : "";
+  }
+  if (points.length === 2) {
+    return `M${points[0].x},${points[0].y} L${points[1].x},${points[1].y}`;
+  }
+  const pathParts = [`M${points[0].x},${points[0].y}`];
+  for (let i = 0; i < points.length - 1; i++) {
+    const p0 = points[Math.max(0, i - 1)];
+    const p1 = points[i];
+    const p2 = points[i + 1];
+    const p3 = points[Math.min(points.length - 1, i + 2)];
+    const cp1x = p1.x + (p2.x - p0.x) / 6;
+    const cp1y = p1.y + (p2.y - p0.y) / 6;
+    const cp2x = p2.x - (p3.x - p1.x) / 6;
+    const cp2y = p2.y - (p3.y - p1.y) / 6;
+    pathParts.push(`C${cp1x},${cp1y} ${cp2x},${cp2y} ${p2.x},${p2.y}`);
+  }
+  return pathParts.join(" ");
+}
+function getLinePath(points, curved) {
+  if (!Array.isArray(points)) {
+    return void 0;
+  }
+  if (points.length === 0) {
+    return "";
+  }
+  for (const point of points) {
+    if (typeof point !== "object" || point === null || typeof point.x !== "number" || typeof point.y !== "number") {
+      return void 0;
+    }
+  }
+  const validPoints = points;
+  if (validPoints.length === 1) {
+    return `M${validPoints[0].x},${validPoints[0].y}`;
+  }
+  if (curved !== true) {
+    const pathParts = validPoints.map((point, i) => {
+      const command = i === 0 ? "M" : "L";
+      return `${command}${point.x},${point.y}`;
+    });
+    return pathParts.join(" ");
+  }
+  return getCurvedPath(validPoints);
+}
+var CHART_HELPERS = {
+  normalizeValue: (value, min, max) => normalizeValue(value, min, max),
+  scaleValue: (value, domainMin, domainMax, rangeMin, rangeMax) => scaleValue(value, domainMin, domainMax, rangeMin, rangeMax),
+  getChartBounds: (data, valueKey) => getChartBounds(data, valueKey),
+  getLinePoints: (data, valueKey, width, height, padding) => getLinePoints(data, valueKey, width, height, padding),
+  getLinePath: (points, curved) => getLinePath(points, curved)
+};
+function callChartHelper(method, args) {
+  const fn = CHART_HELPERS[method];
+  if (!fn) {
+    return void 0;
+  }
+  return fn(...args);
+}
 export {
   AI_OUTPUT_TYPES,
   AI_PROVIDER_TYPES,
   BINARY_OPERATORS,
+  CHART_HELPERS,
   CLIPBOARD_OPERATIONS,
   COLOR_SCHEMES,
   ConstelaError,
@@ -2673,6 +2800,7 @@ export {
   UPDATE_OPERATIONS,
   VALIDITY_PROPERTIES,
   astSchema,
+  callChartHelper,
   createClipboardWriteMissingValueError,
   createComponentCycleError,
   createComponentNotFoundError,
@@ -2715,6 +2843,9 @@ export {
   createUndefinedVariantError,
   createUnsupportedVersionError,
   findSimilarNames,
+  getChartBounds,
+  getLinePath,
+  getLinePoints,
   isActionStep,
   isAiDataSource,
   isArrayExpr,
@@ -2786,5 +2917,7 @@ export {
   isValidityExpr,
   isVarExpr,
   isViewNode,
+  normalizeValue,
+  scaleValue,
   validateAst
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constela/core",
-  "version": "0.18.2",
+  "version": "0.18.4",
   "description": "Core types, schema, and validator for Constela UI framework",
   "type": "module",
   "main": "./dist/index.js",