@constela/core 0.5.0 → 0.7.0

package/dist/index.d.ts

@@ -111,7 +111,14 @@ interface DataExpr {
     name: string;
     path?: string;
 }
-type Expression = LitExpr | StateExpr | VarExpr | BinExpr | NotExpr | ParamExpr | CondExpr | GetExpr | RouteExpr | ImportExpr | DataExpr;
+/**
+ * Ref expression - references a DOM element by ref name
+ */
+interface RefExpr {
+    expr: 'ref';
+    name: string;
+}
+type Expression = LitExpr | StateExpr | VarExpr | BinExpr | NotExpr | ParamExpr | CondExpr | GetExpr | RouteExpr | ImportExpr | DataExpr | RefExpr;
 /**
  * Number state field
  */
@@ -229,7 +236,46 @@ interface NavigateStep {
     target?: NavigateTarget;
     replace?: boolean;
 }
-type ActionStep = SetStep | UpdateStep | FetchStep | StorageStep | ClipboardStep | NavigateStep;
+/**
+ * Import step - dynamically imports an external module
+ * Module name must be a static string for bundler optimization
+ */
+interface ImportStep {
+    do: 'import';
+    module: string;
+    result: string;
+    onSuccess?: ActionStep[];
+    onError?: ActionStep[];
+}
+/**
+ * Call step - calls a function on an external library
+ */
+interface CallStep {
+    do: 'call';
+    target: Expression;
+    args?: Expression[];
+    result?: string;
+    onSuccess?: ActionStep[];
+    onError?: ActionStep[];
+}
+/**
+ * Subscribe step - subscribes to an event on an object
+ * Subscription is auto-collected and disposed on lifecycle.onUnmount
+ */
+interface SubscribeStep {
+    do: 'subscribe';
+    target: Expression;
+    event: string;
+    action: string;
+}
+/**
+ * Dispose step - manually disposes a resource
+ */
+interface DisposeStep {
+    do: 'dispose';
+    target: Expression;
+}
+type ActionStep = SetStep | UpdateStep | FetchStep | StorageStep | ClipboardStep | NavigateStep | ImportStep | CallStep | SubscribeStep | DisposeStep;
 /**
  * Event handler - binds an event to an action
  */
@@ -251,6 +297,7 @@ interface ActionDefinition {
 interface ElementNode {
     kind: 'element';
     tag: string;
+    ref?: string;
     props?: Record<string, Expression | EventHandler>;
     children?: ViewNode[];
 }
@@ -328,6 +375,13 @@ type DataTransform = (typeof DATA_TRANSFORMS)[number];
  */
 declare const DATA_SOURCE_TYPES: readonly ["glob", "file", "api"];
 type DataSourceType = (typeof DATA_SOURCE_TYPES)[number];
+/**
+ * Reference to imported components for MDX transformation
+ */
+interface ComponentsRef {
+    expr: 'import';
+    name: string;
+}
 /**
  * Data source for build-time content loading
  */
@@ -337,6 +391,7 @@ interface DataSource {
     path?: string;
     url?: string;
     transform?: DataTransform;
+    components?: string | ComponentsRef;
 }
 /**
  * Static paths definition for SSG
@@ -470,6 +525,10 @@ declare function isImportExpr(value: unknown): value is ImportExpr;
  * Checks if value is a data expression
  */
 declare function isDataExpr(value: unknown): value is DataExpr;
+/**
+ * Checks if value is a ref expression
+ */
+declare function isRefExpr(value: unknown): value is RefExpr;
 /**
  * Checks if value is a data source
  */
@@ -546,6 +605,22 @@ declare function isClipboardStep(value: unknown): value is ClipboardStep;
  * Checks if value is a navigate step
  */
 declare function isNavigateStep(value: unknown): value is NavigateStep;
+/**
+ * Checks if value is an import step
+ */
+declare function isImportStep(value: unknown): value is ImportStep;
+/**
+ * Checks if value is a call step
+ */
+declare function isCallStep(value: unknown): value is CallStep;
+/**
+ * Checks if value is a subscribe step
+ */
+declare function isSubscribeStep(value: unknown): value is SubscribeStep;
+/**
+ * Checks if value is a dispose step
+ */
+declare function isDisposeStep(value: unknown): value is DisposeStep;
 /**
  * Checks if value is any valid action step
  */
@@ -602,7 +677,7 @@ declare function isLifecycleHooks(value: unknown): value is LifecycleHooks;
  * This module defines error types, the ConstelaError class,
  * and factory functions for creating specific errors.
  */
-type ErrorCode = 'SCHEMA_INVALID' | 'UNDEFINED_STATE' | 'UNDEFINED_ACTION' | 'VAR_UNDEFINED' | 'DUPLICATE_ACTION' | 'UNSUPPORTED_VERSION' | 'COMPONENT_NOT_FOUND' | 'COMPONENT_PROP_MISSING' | 'COMPONENT_CYCLE' | 'COMPONENT_PROP_TYPE' | 'PARAM_UNDEFINED' | 'OPERATION_INVALID_FOR_TYPE' | 'OPERATION_MISSING_FIELD' | 'OPERATION_UNKNOWN' | 'EXPR_INVALID_BASE' | 'EXPR_INVALID_CONDITION' | 'EXPR_COND_ELSE_REQUIRED' | 'UNDEFINED_ROUTE_PARAM' | 'ROUTE_NOT_DEFINED' | 'UNDEFINED_IMPORT' | 'IMPORTS_NOT_DEFINED' | 'LAYOUT_MISSING_SLOT' | 'LAYOUT_NOT_FOUND' | 'INVALID_SLOT_NAME' | 'DUPLICATE_SLOT_NAME' | 'DUPLICATE_DEFAULT_SLOT' | 'SLOT_IN_LOOP' | 'INVALID_DATA_SOURCE' | 'UNDEFINED_DATA_SOURCE' | 'DATA_NOT_DEFINED' | 'UNDEFINED_DATA' | 'INVALID_STORAGE_OPERATION' | 'INVALID_STORAGE_TYPE' | 'STORAGE_SET_MISSING_VALUE' | 'INVALID_CLIPBOARD_OPERATION' | 'CLIPBOARD_WRITE_MISSING_VALUE' | 'INVALID_NAVIGATE_TARGET';
+type ErrorCode = 'SCHEMA_INVALID' | 'UNDEFINED_STATE' | 'UNDEFINED_ACTION' | 'VAR_UNDEFINED' | 'DUPLICATE_ACTION' | 'UNSUPPORTED_VERSION' | 'COMPONENT_NOT_FOUND' | 'COMPONENT_PROP_MISSING' | 'COMPONENT_CYCLE' | 'COMPONENT_PROP_TYPE' | 'PARAM_UNDEFINED' | 'OPERATION_INVALID_FOR_TYPE' | 'OPERATION_MISSING_FIELD' | 'OPERATION_UNKNOWN' | 'EXPR_INVALID_BASE' | 'EXPR_INVALID_CONDITION' | 'EXPR_COND_ELSE_REQUIRED' | 'UNDEFINED_ROUTE_PARAM' | 'ROUTE_NOT_DEFINED' | 'UNDEFINED_IMPORT' | 'IMPORTS_NOT_DEFINED' | 'LAYOUT_MISSING_SLOT' | 'LAYOUT_NOT_FOUND' | 'INVALID_SLOT_NAME' | 'DUPLICATE_SLOT_NAME' | 'DUPLICATE_DEFAULT_SLOT' | 'SLOT_IN_LOOP' | 'INVALID_DATA_SOURCE' | 'UNDEFINED_DATA_SOURCE' | 'DATA_NOT_DEFINED' | 'UNDEFINED_DATA' | 'UNDEFINED_REF' | 'INVALID_STORAGE_OPERATION' | 'INVALID_STORAGE_TYPE' | 'STORAGE_SET_MISSING_VALUE' | 'INVALID_CLIPBOARD_OPERATION' | 'CLIPBOARD_WRITE_MISSING_VALUE' | 'INVALID_NAVIGATE_TARGET';
 /**
  * Custom error class for Constela validation errors
  */
@@ -739,6 +814,10 @@ declare function createDataNotDefinedError(path?: string): ConstelaError;
  * Creates an undefined data error (for DataExpr references)
  */
 declare function createUndefinedDataError(dataName: string, path?: string): ConstelaError;
+/**
+ * Creates an undefined ref error
+ */
+declare function createUndefinedRefError(refName: string, path?: string): ConstelaError;
 /**
  * Creates an invalid storage operation error
  */
@@ -1407,4 +1486,4 @@ declare const astSchema: {
     };
 };
 
-export { type ActionDefinition, type ActionStep, BINARY_OPERATORS, type BinExpr, type BinaryOperator, type BooleanField, CLIPBOARD_OPERATIONS, type ClipboardOperation, type ClipboardStep, type CodeNode, type ComponentDef, type ComponentNode, type CondExpr, type ConstelaAst, ConstelaError, type ConstelaProgram, DATA_SOURCE_TYPES, DATA_TRANSFORMS, type DataExpr, type DataSource, type DataSourceType, type DataTransform, type EachNode, type ElementNode, type ErrorCode, type EventHandler, type Expression, type FetchStep, type GetExpr, HTTP_METHODS, type HttpMethod, type IfNode, type ImportExpr, type LayoutProgram, type LifecycleHooks, type ListField, type LitExpr, type MarkdownNode, NAVIGATE_TARGETS, type NavigateStep, type NavigateTarget, type NotExpr, type NumberField, type ObjectField, PARAM_TYPES, type ParamDef, type ParamExpr, type ParamType, type Program, type RouteDefinition, type RouteExpr, STORAGE_OPERATIONS, STORAGE_TYPES, type SetStep, type SlotNode, type StateExpr, type StateField, type StaticPathsDefinition, type StorageOperation, type StorageStep, type StorageType, type StringField, type TextNode, UPDATE_OPERATIONS, type UpdateOperation, type UpdateStep, type ValidationFailure, type ValidationResult, type ValidationSuccess, type VarExpr, type ViewNode, astSchema, createClipboardWriteMissingValueError, createComponentCycleError, createComponentNotFoundError, createComponentPropMissingError, createComponentPropTypeError, createCondElseRequiredError, createDataNotDefinedError, createDuplicateActionError, createDuplicateDefaultSlotError, createDuplicateSlotNameError, createImportsNotDefinedError, createInvalidClipboardOperationError, createInvalidDataSourceError, createInvalidNavigateTargetError, createInvalidSlotNameError, createInvalidStorageOperationError, createInvalidStorageTypeError, createLayoutMissingSlotError, createLayoutNotFoundError, createOperationInvalidForTypeError, createOperationMissingFieldError, createOperationUnknownError, createRouteNotDefinedError, createSchemaError, createSlotInLoopError, createStorageSetMissingValueError, createUndefinedActionError, createUndefinedDataError, createUndefinedDataSourceError, createUndefinedImportError, createUndefinedParamError, createUndefinedRouteParamError, createUndefinedStateError, createUndefinedVarError, createUnsupportedVersionError, isActionStep, isBinExpr, isBooleanField, isClipboardStep, isCodeNode, isComponentNode, isCondExpr, isConstelaError, isDataExpr, isDataSource, isEachNode, isElementNode, isEventHandler, isExpression, isFetchStep, isGetExpr, isIfNode, isImportExpr, isLayoutProgram, isLifecycleHooks, isListField, isLitExpr, isMarkdownNode, isNamedSlotNode, isNavigateStep, isNotExpr, isNumberField, isObjectField, isParamExpr, isRouteDefinition, isRouteExpr, isSetStep, isSlotNode, isStateExpr, isStateField, isStaticPathsDefinition, isStorageStep, isStringField, isTextNode, isUpdateStep, isVarExpr, isViewNode, validateAst };
+export { type ActionDefinition, type ActionStep, BINARY_OPERATORS, type BinExpr, type BinaryOperator, type BooleanField, CLIPBOARD_OPERATIONS, type CallStep, type ClipboardOperation, type ClipboardStep, type CodeNode, type ComponentDef, type ComponentNode, type ComponentsRef, type CondExpr, type ConstelaAst, ConstelaError, type ConstelaProgram, DATA_SOURCE_TYPES, DATA_TRANSFORMS, type DataExpr, type DataSource, type DataSourceType, type DataTransform, type DisposeStep, type EachNode, type ElementNode, type ErrorCode, type EventHandler, type Expression, type FetchStep, type GetExpr, HTTP_METHODS, type HttpMethod, type IfNode, type ImportExpr, type ImportStep, type LayoutProgram, type LifecycleHooks, type ListField, type LitExpr, type MarkdownNode, NAVIGATE_TARGETS, type NavigateStep, type NavigateTarget, type NotExpr, type NumberField, type ObjectField, PARAM_TYPES, type ParamDef, type ParamExpr, type ParamType, type Program, type RefExpr, type RouteDefinition, type RouteExpr, STORAGE_OPERATIONS, STORAGE_TYPES, type SetStep, type SlotNode, type StateExpr, type StateField, type StaticPathsDefinition, type StorageOperation, type StorageStep, type StorageType, type StringField, type SubscribeStep, type TextNode, UPDATE_OPERATIONS, type UpdateOperation, type UpdateStep, type ValidationFailure, type ValidationResult, type ValidationSuccess, type VarExpr, type ViewNode, astSchema, createClipboardWriteMissingValueError, createComponentCycleError, createComponentNotFoundError, createComponentPropMissingError, createComponentPropTypeError, createCondElseRequiredError, createDataNotDefinedError, createDuplicateActionError, createDuplicateDefaultSlotError, createDuplicateSlotNameError, createImportsNotDefinedError, createInvalidClipboardOperationError, createInvalidDataSourceError, createInvalidNavigateTargetError, createInvalidSlotNameError, createInvalidStorageOperationError, createInvalidStorageTypeError, createLayoutMissingSlotError, createLayoutNotFoundError, createOperationInvalidForTypeError, createOperationMissingFieldError, createOperationUnknownError, createRouteNotDefinedError, createSchemaError, createSlotInLoopError, createStorageSetMissingValueError, createUndefinedActionError, createUndefinedDataError, createUndefinedDataSourceError, createUndefinedImportError, createUndefinedParamError, createUndefinedRefError, createUndefinedRouteParamError, createUndefinedStateError, createUndefinedVarError, createUnsupportedVersionError, isActionStep, isBinExpr, isBooleanField, isCallStep, isClipboardStep, isCodeNode, isComponentNode, isCondExpr, isConstelaError, isDataExpr, isDataSource, isDisposeStep, isEachNode, isElementNode, isEventHandler, isExpression, isFetchStep, isGetExpr, isIfNode, isImportExpr, isImportStep, isLayoutProgram, isLifecycleHooks, isListField, isLitExpr, isMarkdownNode, isNamedSlotNode, isNavigateStep, isNotExpr, isNumberField, isObjectField, isParamExpr, isRefExpr, isRouteDefinition, isRouteExpr, isSetStep, isSlotNode, isStateExpr, isStateField, isStaticPathsDefinition, isStorageStep, isStringField, isSubscribeStep, isTextNode, isUpdateStep, isVarExpr, isViewNode, validateAst };

package/dist/index.js

@@ -118,6 +118,11 @@ function isDataExpr(value) {
   }
   return true;
 }
+function isRefExpr(value) {
+  if (!isObject(value)) return false;
+  if (value["expr"] !== "ref") return false;
+  return typeof value["name"] === "string";
+}
 function isDataSource(value) {
   if (!isObject(value)) return false;
   const type = value["type"];
@@ -154,7 +159,7 @@ function isRouteDefinition(value) {
   return true;
 }
 function isExpression(value) {
-  return isLitExpr(value) || isStateExpr(value) || isVarExpr(value) || isBinExpr(value) || isNotExpr(value) || isParamExpr(value) || isCondExpr(value) || isGetExpr(value) || isRouteExpr(value) || isImportExpr(value) || isDataExpr(value);
+  return isLitExpr(value) || isStateExpr(value) || isVarExpr(value) || isBinExpr(value) || isNotExpr(value) || isParamExpr(value) || isCondExpr(value) || isGetExpr(value) || isRouteExpr(value) || isImportExpr(value) || isDataExpr(value) || isRefExpr(value);
 }
 function isElementNode(value) {
   if (!isObject(value)) return false;
@@ -270,8 +275,35 @@ function isNavigateStep(value) {
   }
   return true;
 }
+function isImportStep(value) {
+  if (!isObject(value)) return false;
+  if (value["do"] !== "import") return false;
+  if (typeof value["module"] !== "string") return false;
+  if (typeof value["result"] !== "string") return false;
+  return true;
+}
+function isCallStep(value) {
+  if (!isObject(value)) return false;
+  if (value["do"] !== "call") return false;
+  if (!isObject(value["target"])) return false;
+  return true;
+}
+function isSubscribeStep(value) {
+  if (!isObject(value)) return false;
+  if (value["do"] !== "subscribe") return false;
+  if (!isObject(value["target"])) return false;
+  if (typeof value["event"] !== "string") return false;
+  if (typeof value["action"] !== "string") return false;
+  return true;
+}
+function isDisposeStep(value) {
+  if (!isObject(value)) return false;
+  if (value["do"] !== "dispose") return false;
+  if (!isObject(value["target"])) return false;
+  return true;
+}
 function isActionStep(value) {
-  return isSetStep(value) || isUpdateStep(value) || isFetchStep(value) || isStorageStep(value) || isClipboardStep(value) || isNavigateStep(value);
+  return isSetStep(value) || isUpdateStep(value) || isFetchStep(value) || isStorageStep(value) || isClipboardStep(value) || isNavigateStep(value) || isImportStep(value) || isCallStep(value) || isSubscribeStep(value) || isDisposeStep(value);
 }
 function isNumberField(value) {
   if (!isObject(value)) return false;
@@ -563,6 +595,13 @@ function createUndefinedDataError(dataName, path) {
     path
   );
 }
+function createUndefinedRefError(refName, path) {
+  return new ConstelaError(
+    "UNDEFINED_REF",
+    `Undefined ref reference: '${refName}' is not defined in view elements`,
+    path
+  );
+}
 function createInvalidStorageOperationError(operation, path) {
   return new ConstelaError(
     "INVALID_STORAGE_OPERATION",
@@ -1612,6 +1651,7 @@ export {
   createUndefinedDataSourceError,
   createUndefinedImportError,
   createUndefinedParamError,
+  createUndefinedRefError,
   createUndefinedRouteParamError,
   createUndefinedStateError,
   createUndefinedVarError,
@@ -1619,6 +1659,7 @@ export {
   isActionStep,
   isBinExpr,
   isBooleanField,
+  isCallStep,
   isClipboardStep,
   isCodeNode,
   isComponentNode,
@@ -1626,6 +1667,7 @@ export {
   isConstelaError,
   isDataExpr,
   isDataSource,
+  isDisposeStep,
   isEachNode,
   isElementNode,
   isEventHandler,
@@ -1634,6 +1676,7 @@ export {
   isGetExpr,
   isIfNode,
   isImportExpr,
+  isImportStep,
   isLayoutProgram,
   isLifecycleHooks,
   isListField,
@@ -1645,6 +1688,7 @@ export {
   isNumberField,
   isObjectField,
   isParamExpr,
+  isRefExpr,
   isRouteDefinition,
   isRouteExpr,
   isSetStep,
@@ -1654,6 +1698,7 @@ export {
   isStaticPathsDefinition,
   isStorageStep,
   isStringField,
+  isSubscribeStep,
   isTextNode,
   isUpdateStep,
   isVarExpr,

package/package.json

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