@constela/core 0.22.0 → 0.23.0

package/dist/index.d.ts

@@ -641,12 +641,23 @@ interface TextNode {
     kind: 'text';
     value: Expression;
 }
+/**
+ * Transition directive for enter/exit animations on if/each nodes
+ */
+interface TransitionDirective {
+    enter: string;
+    enterActive: string;
+    exit: string;
+    exitActive: string;
+    duration?: number;
+}
 /**
  * If node - conditional rendering
  */
 interface IfNode {
     kind: 'if';
     condition: Expression;
+    transition?: TransitionDirective;
     then: ViewNode;
     else?: ViewNode;
 }
@@ -659,6 +670,7 @@ interface EachNode {
     as: string;
     index?: string;
     key?: Expression;
+    transition?: TransitionDirective;
     body: ViewNode;
 }
 /**
@@ -1172,7 +1184,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' | 'UNDEFINED_REF' | 'INVALID_STORAGE_OPERATION' | 'INVALID_STORAGE_TYPE' | 'STORAGE_SET_MISSING_VALUE' | 'INVALID_CLIPBOARD_OPERATION' | 'CLIPBOARD_WRITE_MISSING_VALUE' | 'INVALID_NAVIGATE_TARGET' | 'UNDEFINED_STYLE' | 'UNDEFINED_VARIANT' | 'UNDEFINED_LOCAL_STATE' | 'LOCAL_ACTION_INVALID_STEP' | 'DUPLICATE_ISLAND_ID';
+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' | 'UNDEFINED_STYLE' | 'UNDEFINED_VARIANT' | 'UNDEFINED_LOCAL_STATE' | 'LOCAL_ACTION_INVALID_STEP' | 'DUPLICATE_ISLAND_ID' | 'A11Y_IMG_NO_ALT' | 'A11Y_BUTTON_NO_LABEL' | 'A11Y_ANCHOR_NO_LABEL' | 'A11Y_INPUT_NO_LABEL' | 'A11Y_HEADING_SKIP' | 'A11Y_POSITIVE_TABINDEX' | 'A11Y_DUPLICATE_ID';
 /**
  * Options for creating enhanced ConstelaError instances
  */
@@ -1383,6 +1395,34 @@ declare function createLocalActionInvalidStepError(stepType: string, path?: stri
  * Creates a duplicate island ID error
  */
 declare function createDuplicateIslandIdError(id: string, path?: string, suggestions?: string[]): ConstelaError;
+/**
+ * Creates an a11y error for img missing alt attribute
+ */
+declare function createA11yImgNoAltError(path?: string): ConstelaError;
+/**
+ * Creates an a11y error for button missing accessible label
+ */
+declare function createA11yButtonNoLabelError(path?: string): ConstelaError;
+/**
+ * Creates an a11y error for anchor missing accessible label
+ */
+declare function createA11yAnchorNoLabelError(path?: string): ConstelaError;
+/**
+ * Creates an a11y error for form input missing label
+ */
+declare function createA11yInputNoLabelError(tag: string, path?: string): ConstelaError;
+/**
+ * Creates an a11y error for heading level skip
+ */
+declare function createA11yHeadingSkipError(current: number, expected: number, path?: string): ConstelaError;
+/**
+ * Creates an a11y error for positive tabindex
+ */
+declare function createA11yPositiveTabindexError(value: number, path?: string): ConstelaError;
+/**
+ * Creates an a11y error for duplicate id
+ */
+declare function createA11yDuplicateIdError(id: string, path?: string): ConstelaError;
 /**
  * Finds similar names from a set of candidates using Levenshtein distance
  * and prefix matching.
@@ -2460,6 +2500,12 @@ interface CalendarDay {
  * Whitelist of global helper functions that can be called with target: null
  */
 declare const GLOBAL_FUNCTIONS: Record<string, (...args: unknown[]) => unknown>;
+declare function registerGlobalFunction(name: string, fn: (...args: unknown[]) => unknown): void;
+/**
+ * Unregisters a custom global function.
+ * Built-in functions cannot be unregistered.
+ */
+declare function unregisterGlobalFunction(name: string): void;
 /**
  * Calls a global helper function by name
  *
@@ -2469,6 +2515,20 @@ declare const GLOBAL_FUNCTIONS: Record<string, (...args: unknown[]) => unknown>;
  */
 declare function callGlobalFunction(method: string, args: unknown[]): unknown;
 
+/**
+ * Plugin System for Constela
+ *
+ * Allows external packages to register global helper functions
+ * callable via { "expr": "call", "target": null, "method": "myFunc" }.
+ */
+interface ConstelaPlugin {
+    readonly name: string;
+    readonly globalFunctions?: Record<string, (...args: unknown[]) => unknown>;
+}
+declare function registerPlugin(plugin: ConstelaPlugin): void;
+declare function getRegisteredPlugins(): readonly ConstelaPlugin[];
+declare function clearPlugins(): void;
+
 /**
  * Types for the unified evaluate module.
  *
@@ -2525,4 +2585,4 @@ declare const SAFE_DATE_STATIC_METHODS: Set<string>;
 declare const SAFE_DATE_INSTANCE_METHODS: Set<string>;
 declare const FORBIDDEN_KEYS: Set<string>;
 
-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 CalendarDay, 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, type CoreEvaluationContext, DATA_SOURCE_TYPES, DATA_TRANSFORMS, type DataExpr, type DataSource, type DataSourceType, type DataTransform, type DelayStep, type DisposeStep, type DomStep, type EachNode, type ElementNode, type EnvironmentAdapter, type ErrorBoundaryNode, type ErrorCode, type ErrorOptions, type EventHandler, type EventHandlerOptions, type Expression, FOCUS_OPERATIONS, FORBIDDEN_KEYS, type FetchStep, type FlushStrategy, type FocusOperation, type FocusStep, GLOBAL_FUNCTIONS, 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, SAFE_ARRAY_METHODS, SAFE_DATE_INSTANCE_METHODS, SAFE_DATE_STATIC_METHODS, SAFE_MATH_METHODS, SAFE_STRING_METHODS, type SSECloseStep, type SSEConnectStep, STORAGE_OPERATIONS, STORAGE_TYPES, type SendStep, type SetPathStep, type SetStep, type SlotNode, type StateExpr, type StateField, type StateReader, 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, callGlobalFunction, 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, evaluate, evaluateStyle, 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 };
+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 CalendarDay, 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 ConstelaPlugin, type ConstelaProgram, type CookieInitialExpr, type CoreEvaluationContext, DATA_SOURCE_TYPES, DATA_TRANSFORMS, type DataExpr, type DataSource, type DataSourceType, type DataTransform, type DelayStep, type DisposeStep, type DomStep, type EachNode, type ElementNode, type EnvironmentAdapter, type ErrorBoundaryNode, type ErrorCode, type ErrorOptions, type EventHandler, type EventHandlerOptions, type Expression, FOCUS_OPERATIONS, FORBIDDEN_KEYS, type FetchStep, type FlushStrategy, type FocusOperation, type FocusStep, GLOBAL_FUNCTIONS, 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, SAFE_ARRAY_METHODS, SAFE_DATE_INSTANCE_METHODS, SAFE_DATE_STATIC_METHODS, SAFE_MATH_METHODS, SAFE_STRING_METHODS, type SSECloseStep, type SSEConnectStep, STORAGE_OPERATIONS, STORAGE_TYPES, type SendStep, type SetPathStep, type SetStep, type SlotNode, type StateExpr, type StateField, type StateReader, 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, type TransitionDirective, 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, callGlobalFunction, clearPlugins, createA11yAnchorNoLabelError, createA11yButtonNoLabelError, createA11yDuplicateIdError, createA11yHeadingSkipError, createA11yImgNoAltError, createA11yInputNoLabelError, createA11yPositiveTabindexError, 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, evaluate, evaluateStyle, findSimilarNames, getRegisteredPlugins, 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, registerGlobalFunction, registerPlugin, unregisterGlobalFunction, validateAst };

package/dist/index.js

@@ -944,6 +944,62 @@ function createDuplicateIslandIdError(id, path, suggestions) {
     }
   );
 }
+function createA11yImgNoAltError(path) {
+  return new ConstelaError(
+    "A11Y_IMG_NO_ALT",
+    `Accessibility: <img> element is missing an 'alt' attribute`,
+    path,
+    { severity: "warning", suggestion: `Add an 'alt' attribute to describe the image, or alt="" for decorative images` }
+  );
+}
+function createA11yButtonNoLabelError(path) {
+  return new ConstelaError(
+    "A11Y_BUTTON_NO_LABEL",
+    `Accessibility: <button> element has no text content or 'aria-label'`,
+    path,
+    { severity: "warning", suggestion: `Add text content or an 'aria-label' attribute` }
+  );
+}
+function createA11yAnchorNoLabelError(path) {
+  return new ConstelaError(
+    "A11Y_ANCHOR_NO_LABEL",
+    `Accessibility: <a> element has no text content or 'aria-label'`,
+    path,
+    { severity: "warning", suggestion: `Add text content or an 'aria-label' attribute` }
+  );
+}
+function createA11yInputNoLabelError(tag, path) {
+  return new ConstelaError(
+    "A11Y_INPUT_NO_LABEL",
+    `Accessibility: <${tag}> element has no 'aria-label' or 'aria-labelledby'`,
+    path,
+    { severity: "warning", suggestion: `Add an 'aria-label' or 'aria-labelledby' attribute` }
+  );
+}
+function createA11yHeadingSkipError(current, expected, path) {
+  return new ConstelaError(
+    "A11Y_HEADING_SKIP",
+    `Accessibility: Heading level skipped from h${expected - 1} to h${current}`,
+    path,
+    { severity: "warning", suggestion: `Use h${expected} instead of h${current} to maintain heading hierarchy` }
+  );
+}
+function createA11yPositiveTabindexError(value, path) {
+  return new ConstelaError(
+    "A11Y_POSITIVE_TABINDEX",
+    `Accessibility: Avoid positive tabindex value '${value}'`,
+    path,
+    { severity: "warning", suggestion: `Use tabindex="0" or tabindex="-1" instead` }
+  );
+}
+function createA11yDuplicateIdError(id, path) {
+  return new ConstelaError(
+    "A11Y_DUPLICATE_ID",
+    `Accessibility: Duplicate id '${id}' found`,
+    path,
+    { severity: "warning", suggestion: `Use unique id values for each element` }
+  );
+}
 function levenshteinDistance(a, b) {
   const aLen = a.length;
   const bLen = b.length;
@@ -996,6 +1052,23 @@ var VALID_STATE_TYPES = ["number", "string", "list", "boolean", "object"];
 var VALID_BIN_OPS = BINARY_OPERATORS;
 var VALID_UPDATE_OPS = UPDATE_OPERATIONS;
 var VALID_HTTP_METHODS = HTTP_METHODS;
+function validateTransitionDirective(transition, path) {
+  if (typeof transition !== "object" || transition === null) {
+    return { path, message: "transition must be an object" };
+  }
+  const t = transition;
+  for (const field of ["enter", "enterActive", "exit", "exitActive"]) {
+    if (typeof t[field] !== "string") {
+      return { path: path + "/" + field, message: `${field} must be a string` };
+    }
+  }
+  if ("duration" in t && t["duration"] !== void 0) {
+    if (typeof t["duration"] !== "number" || t["duration"] < 0) {
+      return { path: path + "/duration", message: "duration must be a non-negative number" };
+    }
+  }
+  return null;
+}
 function validateViewNode(node, path) {
   if (!isObject3(node)) {
     return { path, message: "must be an object" };
@@ -1043,6 +1116,10 @@ function validateViewNode(node, path) {
       {
         const condError = validateExpression(node["condition"], path + "/condition");
         if (condError) return condError;
+        if ("transition" in node) {
+          const transError = validateTransitionDirective(node["transition"], path + "/transition");
+          if (transError) return transError;
+        }
         const thenError = validateViewNode(node["then"], path + "/then");
         if (thenError) return thenError;
         if ("else" in node) {
@@ -1064,6 +1141,10 @@ function validateViewNode(node, path) {
       {
         const itemsError = validateExpression(node["items"], path + "/items");
         if (itemsError) return itemsError;
+        if ("transition" in node) {
+          const transError = validateTransitionDirective(node["transition"], path + "/transition");
+          if (transError) return transError;
+        }
         const bodyError = validateViewNode(node["body"], path + "/body");
         if (bodyError) return bodyError;
       }
@@ -3673,6 +3754,26 @@ var GLOBAL_FUNCTIONS = {
     return nums.length > 0 ? Math.max(...nums) : void 0;
   }
 };
+var BUILTIN_FUNCTION_NAMES = new Set(Object.keys(GLOBAL_FUNCTIONS));
+var FORBIDDEN_FUNCTION_NAMES = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
+function registerGlobalFunction(name, fn) {
+  if (FORBIDDEN_FUNCTION_NAMES.has(name)) {
+    throw new Error(`Cannot register global function '${name}': forbidden name`);
+  }
+  if (BUILTIN_FUNCTION_NAMES.has(name)) {
+    throw new Error(`Cannot register global function '${name}': conflicts with built-in function`);
+  }
+  if (name in GLOBAL_FUNCTIONS) {
+    throw new Error(`Cannot register global function '${name}': already registered`);
+  }
+  GLOBAL_FUNCTIONS[name] = fn;
+}
+function unregisterGlobalFunction(name) {
+  if (BUILTIN_FUNCTION_NAMES.has(name)) {
+    throw new Error(`Cannot unregister built-in function '${name}'`);
+  }
+  delete GLOBAL_FUNCTIONS[name];
+}
 function callGlobalFunction(method, args) {
   const fn = GLOBAL_FUNCTIONS[method];
   if (!fn) {
@@ -3681,6 +3782,42 @@ function callGlobalFunction(method, args) {
   return fn(...args);
 }
 
+// src/plugin/index.ts
+var registeredPlugins = [];
+function registerPlugin(plugin) {
+  if (registeredPlugins.some((p) => p.name === plugin.name)) {
+    throw new Error(`Plugin '${plugin.name}' is already registered`);
+  }
+  if (plugin.globalFunctions) {
+    const registeredNames = [];
+    try {
+      for (const [name, fn] of Object.entries(plugin.globalFunctions)) {
+        registerGlobalFunction(name, fn);
+        registeredNames.push(name);
+      }
+    } catch (error) {
+      for (const name of registeredNames) {
+        unregisterGlobalFunction(name);
+      }
+      throw error;
+    }
+  }
+  registeredPlugins.push(plugin);
+}
+function getRegisteredPlugins() {
+  return [...registeredPlugins];
+}
+function clearPlugins() {
+  for (const plugin of registeredPlugins) {
+    if (plugin.globalFunctions) {
+      for (const name of Object.keys(plugin.globalFunctions)) {
+        unregisterGlobalFunction(name);
+      }
+    }
+  }
+  registeredPlugins.length = 0;
+}
+
 // src/evaluate/constants.ts
 var SAFE_ARRAY_METHODS = /* @__PURE__ */ new Set([
   "length",
@@ -4275,6 +4412,14 @@ export {
   VALIDITY_PROPERTIES,
   astSchema,
   callGlobalFunction,
+  clearPlugins,
+  createA11yAnchorNoLabelError,
+  createA11yButtonNoLabelError,
+  createA11yDuplicateIdError,
+  createA11yHeadingSkipError,
+  createA11yImgNoAltError,
+  createA11yInputNoLabelError,
+  createA11yPositiveTabindexError,
   createClipboardWriteMissingValueError,
   createComponentCycleError,
   createComponentNotFoundError,
@@ -4319,6 +4464,7 @@ export {
   evaluate,
   evaluateStyle,
   findSimilarNames,
+  getRegisteredPlugins,
   isActionStep,
   isAiDataSource,
   isArrayExpr,
@@ -4390,5 +4536,8 @@ export {
   isValidityExpr,
   isVarExpr,
   isViewNode,
+  registerGlobalFunction,
+  registerPlugin,
+  unregisterGlobalFunction,
   validateAst
 };

package/package.json

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