@constela/core 0.16.1 → 0.16.2

package/dist/index.d.ts

@@ -429,7 +429,20 @@ interface IfStep {
     then: ActionStep[];
     else?: ActionStep[];
 }
-type ActionStep = SetStep | UpdateStep | SetPathStep | FetchStep | StorageStep | ClipboardStep | NavigateStep | ImportStep | CallStep | SubscribeStep | DisposeStep | DomStep | SendStep | CloseStep | DelayStep | IntervalStep | ClearTimerStep | FocusStep | IfStep;
+/**
+ * Generate step - generates DSL using AI at runtime
+ */
+interface GenerateStep {
+    do: 'generate';
+    provider: AiProviderType;
+    prompt: Expression;
+    output: AiOutputType;
+    result: string;
+    model?: string;
+    onSuccess?: ActionStep[];
+    onError?: ActionStep[];
+}
+type ActionStep = SetStep | UpdateStep | SetPathStep | FetchStep | StorageStep | ClipboardStep | NavigateStep | ImportStep | CallStep | SubscribeStep | DisposeStep | DomStep | SendStep | CloseStep | DelayStep | IntervalStep | ClearTimerStep | FocusStep | IfStep | GenerateStep;
 type LocalActionStep = SetStep | UpdateStep | SetPathStep;
 /**
  * Event handler options for special events like intersect
@@ -573,7 +586,7 @@ type DataTransform = (typeof DATA_TRANSFORMS)[number];
 /**
  * Data source types
  */
-declare const DATA_SOURCE_TYPES: readonly ["glob", "file", "api"];
+declare const DATA_SOURCE_TYPES: readonly ["glob", "file", "api", "ai"];
 type DataSourceType = (typeof DATA_SOURCE_TYPES)[number];
 /**
  * Reference to imported components for MDX transformation
@@ -593,6 +606,26 @@ interface DataSource {
     transform?: DataTransform;
     components?: string | ComponentsRef;
 }
+/**
+ * AI provider types for AI data source
+ */
+declare const AI_PROVIDER_TYPES: readonly ["anthropic", "openai"];
+type AiProviderType = (typeof AI_PROVIDER_TYPES)[number];
+/**
+ * AI output types for AI data source
+ */
+declare const AI_OUTPUT_TYPES: readonly ["component", "view"];
+type AiOutputType = (typeof AI_OUTPUT_TYPES)[number];
+/**
+ * AI data source for AI-generated content at build time
+ */
+interface AiDataSource {
+    type: 'ai';
+    provider: AiProviderType;
+    prompt: string;
+    output: AiOutputType;
+    model?: string;
+}
 /**
  * Static paths definition for SSG
  */
@@ -766,6 +799,14 @@ declare function isValidityExpr(value: unknown): value is ValidityExpr;
  * Checks if value is a data source
  */
 declare function isDataSource(value: unknown): value is DataSource;
+/**
+ * Checks if value is an AI data source
+ */
+declare function isAiDataSource(value: unknown): value is AiDataSource;
+/**
+ * Checks if value is a GenerateStep
+ */
+declare function isGenerateStep(value: unknown): value is GenerateStep;
 /**
  * Checks if value is a static paths definition
  */
@@ -2103,4 +2144,4 @@ declare const astSchema: {
     };
 };
 
-export { type ActionDefinition, type ActionStep, type ArrayExpr, BINARY_OPERATORS, type BinExpr, type BinaryOperator, type BooleanField, CLIPBOARD_OPERATIONS, type CallExpr, type CallStep, type ClearTimerStep, type ClipboardOperation, type ClipboardStep, type CloseStep, type CodeNode, type ComponentDef, type ComponentNode, type ComponentsRef, type CompoundVariant, type ConcatExpr, type CondExpr, 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 ErrorCode, type ErrorOptions, type EventHandler, type EventHandlerOptions, type Expression, FOCUS_OPERATIONS, type FetchStep, type FocusOperation, type FocusStep, type GetExpr, HTTP_METHODS, type HttpMethod, type IfNode, type IfStep, type ImportExpr, type ImportStep, type IndexExpr, type IntervalStep, type LambdaExpr, type LayoutProgram, type LifecycleHooks, type ListField, type LitExpr, type LocalActionDefinition, type LocalActionStep, type MarkdownNode, NAVIGATE_TARGETS, type NavigateStep, type NavigateTarget, type NotExpr, type NumberField, type ObjectField, PARAM_TYPES, type ParamDef, type ParamExpr, type ParamType, type PortalNode, type Program, type RefExpr, type RouteDefinition, type RouteExpr, 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 StringField, type StyleExpr, type StylePreset, type SubscribeStep, type TextNode, UPDATE_OPERATIONS, 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, 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, isArrayExpr, isBinExpr, isBooleanField, isCallStep, isClipboardStep, isCodeNode, isComponentNode, isConcatExpr, isCondExpr, isConstelaError, isCookieInitialExpr, isDataExpr, isDataSource, isDisposeStep, isEachNode, isElementNode, isEventHandler, isExpression, isFetchStep, isFocusStep, isGetExpr, isIfNode, isImportExpr, isImportStep, isLayoutProgram, isLifecycleHooks, isListField, isLitExpr, isLocalActionDefinition, isLocalActionStep, isMarkdownNode, isNamedSlotNode, isNavigateStep, isNotExpr, isNumberField, isObjectField, isParamExpr, isPortalNode, isRefExpr, isRouteDefinition, isRouteExpr, isSetPathStep, isSetStep, isSlotNode, isStateExpr, isStateField, isStaticPathsDefinition, isStorageStep, isStringField, isStyleExpr, isSubscribeStep, isTextNode, isUpdateStep, isValidityExpr, isVarExpr, isViewNode, validateAst };
+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 BooleanField, CLIPBOARD_OPERATIONS, type CallExpr, type CallStep, type ClearTimerStep, type ClipboardOperation, type ClipboardStep, type CloseStep, type CodeNode, type ComponentDef, type ComponentNode, type ComponentsRef, type CompoundVariant, type ConcatExpr, type CondExpr, 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 ErrorCode, type ErrorOptions, type EventHandler, type EventHandlerOptions, type Expression, FOCUS_OPERATIONS, type FetchStep, type FocusOperation, type FocusStep, type GenerateStep, type GetExpr, HTTP_METHODS, type HttpMethod, type IfNode, type IfStep, type ImportExpr, type ImportStep, type IndexExpr, type IntervalStep, type LambdaExpr, type LayoutProgram, type LifecycleHooks, type ListField, type LitExpr, type LocalActionDefinition, type LocalActionStep, type MarkdownNode, NAVIGATE_TARGETS, type NavigateStep, type NavigateTarget, type NotExpr, type NumberField, type ObjectField, PARAM_TYPES, type ParamDef, type ParamExpr, type ParamType, type PortalNode, type Program, type RefExpr, type RouteDefinition, type RouteExpr, 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 StringField, type StyleExpr, type StylePreset, type SubscribeStep, type TextNode, UPDATE_OPERATIONS, 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, 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, isComponentNode, isConcatExpr, isCondExpr, isConstelaError, isCookieInitialExpr, isDataExpr, isDataSource, isDisposeStep, isEachNode, isElementNode, isEventHandler, isExpression, isFetchStep, isFocusStep, isGenerateStep, isGetExpr, isIfNode, isImportExpr, isImportStep, isLayoutProgram, isLifecycleHooks, isListField, isLitExpr, isLocalActionDefinition, isLocalActionStep, isMarkdownNode, isNamedSlotNode, isNavigateStep, isNotExpr, isNumberField, isObjectField, isParamExpr, isPortalNode, isRefExpr, isRouteDefinition, isRouteExpr, isSetPathStep, isSetStep, isSlotNode, isStateExpr, isStateField, isStaticPathsDefinition, isStorageStep, isStringField, isStyleExpr, isSubscribeStep, isTextNode, isUpdateStep, isValidityExpr, isVarExpr, isViewNode, validateAst };

package/dist/index.js

@@ -45,7 +45,9 @@ var VALIDITY_PROPERTIES = [
 var NAVIGATE_TARGETS = ["_self", "_blank"];
 var PARAM_TYPES = ["string", "number", "boolean", "json"];
 var DATA_TRANSFORMS = ["mdx", "yaml", "csv"];
-var DATA_SOURCE_TYPES = ["glob", "file", "api"];
+var DATA_SOURCE_TYPES = ["glob", "file", "api", "ai"];
+var AI_PROVIDER_TYPES = ["anthropic", "openai"];
+var AI_OUTPUT_TYPES = ["component", "view"];
 
 // src/types/guards.ts
 function isObject(value) {
@@ -190,9 +192,28 @@ function isDataSource(value) {
     case "api":
       if (typeof value["url"] !== "string") return false;
       break;
+    case "ai":
+      return isAiDataSource(value);
   }
   return true;
 }
+function isAiDataSource(value) {
+  if (!isObject(value)) return false;
+  if (value["type"] !== "ai") return false;
+  if (!AI_PROVIDER_TYPES.includes(value["provider"])) return false;
+  if (typeof value["prompt"] !== "string") return false;
+  if (!AI_OUTPUT_TYPES.includes(value["output"])) return false;
+  return true;
+}
+function isGenerateStep(value) {
+  if (!isObject(value)) return false;
+  if (value["do"] !== "generate") return false;
+  if (!AI_PROVIDER_TYPES.includes(value["provider"])) return false;
+  if (!("prompt" in value)) return false;
+  if (!AI_OUTPUT_TYPES.includes(value["output"])) return false;
+  if (typeof value["result"] !== "string") return false;
+  return true;
+}
 function isStaticPathsDefinition(value) {
   if (!isObject(value)) return false;
   if (typeof value["source"] !== "string") return false;
@@ -393,7 +414,7 @@ function isFocusStep(value) {
   return true;
 }
 function isActionStep(value) {
-  return isSetStep(value) || isUpdateStep(value) || isSetPathStep(value) || isFetchStep(value) || isStorageStep(value) || isClipboardStep(value) || isNavigateStep(value) || isImportStep(value) || isCallStep(value) || isSubscribeStep(value) || isDisposeStep(value) || isDelayStep(value) || isIntervalStep(value) || isClearTimerStep(value) || isFocusStep(value);
+  return isSetStep(value) || isUpdateStep(value) || isSetPathStep(value) || isFetchStep(value) || isStorageStep(value) || isClipboardStep(value) || isNavigateStep(value) || isImportStep(value) || isCallStep(value) || isSubscribeStep(value) || isDisposeStep(value) || isDelayStep(value) || isIntervalStep(value) || isClearTimerStep(value) || isFocusStep(value) || isGenerateStep(value);
 }
 function isLocalActionStep(value) {
   return isSetStep(value) || isUpdateStep(value) || isSetPathStep(value);
@@ -2247,6 +2268,8 @@ var astSchema = {
   }
 };
 export {
+  AI_OUTPUT_TYPES,
+  AI_PROVIDER_TYPES,
   BINARY_OPERATORS,
   CLIPBOARD_OPERATIONS,
   ConstelaError,
@@ -2303,6 +2326,7 @@ export {
   createUnsupportedVersionError,
   findSimilarNames,
   isActionStep,
+  isAiDataSource,
   isArrayExpr,
   isBinExpr,
   isBooleanField,
@@ -2323,6 +2347,7 @@ export {
   isExpression,
   isFetchStep,
   isFocusStep,
+  isGenerateStep,
   isGetExpr,
   isIfNode,
   isImportExpr,

package/package.json

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