IncludeCPP 3.7.1__py3-none-any.whl → 3.7.25__py3-none-any.whl

includecpp/core/cssl/cssl_builtins.py

@@ -307,6 +307,10 @@ class CSSLBuiltins:
         self._functions['dataspace'] = self.builtin_dataspace
         self._functions['openquote'] = self.builtin_openquote
         self._functions['OpenFind'] = self.builtin_openfind
+        self._functions['vector'] = self.builtin_vector
+        self._functions['array'] = self.builtin_array
+        self._functions['stack'] = self.builtin_stack
+        self._functions['map'] = self.builtin_map
 
         # Print aliases for CSSL
         self._functions['printl'] = self.builtin_println  # CSSL uses printl for println
@@ -433,13 +437,50 @@ class CSSLBuiltins:
     # ============= Type Checking =============
 
     def builtin_typeof(self, value: Any) -> str:
-        """Get type name"""
+        """Get type name - returns CSSL-specific type names for CSSL types"""
         if value is None:
             return 'null'
+
+        # Check CSSL-specific types first
+        from .cssl_types import (Vector, Array, Stack, DataStruct,
+                                  List as CSSLList, Dictionary, Map,
+                                  Shuffled, Iterator, Combo, DataSpace,
+                                  OpenQuote, Parameter, CSSLInstance)
+
+        if isinstance(value, Vector):
+            return 'vector'
+        elif isinstance(value, Array):
+            return 'array'
+        elif isinstance(value, Stack):
+            return 'stack'
+        elif isinstance(value, DataStruct):
+            return 'datastruct'
+        elif isinstance(value, CSSLList):
+            return 'list'
+        elif isinstance(value, Dictionary):
+            return 'dictionary'
+        elif isinstance(value, Map):
+            return 'map'
+        elif isinstance(value, Shuffled):
+            return 'shuffled'
+        elif isinstance(value, Iterator):
+            return 'iterator'
+        elif isinstance(value, Combo):
+            return 'combo'
+        elif isinstance(value, DataSpace):
+            return 'dataspace'
+        elif isinstance(value, OpenQuote):
+            return 'openquote'
+        elif isinstance(value, Parameter):
+            return 'parameter'
+        elif isinstance(value, CSSLInstance):
+            return value._class.name
+
+        # Python types as fallback
         type_map = {
             int: 'int',
             float: 'float',
-            str: 'str',
+            str: 'string',
             bool: 'bool',
             list: 'list',
             dict: 'dict',
@@ -1044,6 +1085,13 @@ class CSSLBuiltins:
         Usage: instance::getMethods(@module) or instance::getMethods($obj)
         Returns list of method names.
         """
+        from .cssl_types import CSSLInstance
+
+        # Handle CSSL class instances
+        if isinstance(obj, CSSLInstance):
+            return list(obj._class.methods.keys())
+
+        # Handle Python objects
         import inspect
         methods = []
         for name in dir(obj):
@@ -1056,8 +1104,20 @@ class CSSLBuiltins:
     def builtin_instance_getClasses(self, obj: Any) -> list:
         """Get all classes from an object/module.
         Usage: instance::getClasses(@module)
-        Returns list of class names.
+        Returns list of class names (including merged classes).
         """
+        from .cssl_types import CSSLInstance
+
+        # Handle CSSL class instances
+        if isinstance(obj, CSSLInstance):
+            classes = [obj._class.name]  # Primary class
+            # Check for merged class instances in members
+            for name, member in obj._members.items():
+                if isinstance(member, CSSLInstance):
+                    classes.append(member._class.name)
+            return classes
+
+        # Handle Python objects
         import inspect
         classes = []
         for name in dir(obj):
@@ -1070,8 +1130,20 @@ class CSSLBuiltins:
     def builtin_instance_getVars(self, obj: Any) -> list:
         """Get all variables/attributes (non-callable) from an object.
         Usage: instance::getVars(@module)
-        Returns list of variable names.
+        Returns list of variable names (excludes merged class instances).
         """
+        from .cssl_types import CSSLInstance
+
+        # Handle CSSL class instances
+        if isinstance(obj, CSSLInstance):
+            vars_list = []
+            for name, member in obj._members.items():
+                # Exclude merged class instances
+                if not isinstance(member, CSSLInstance):
+                    vars_list.append(name)
+            return vars_list
+
+        # Handle Python objects
         vars_list = []
         for name in dir(obj):
             if not name.startswith('_'):
@@ -1085,12 +1157,31 @@ class CSSLBuiltins:
         Usage: instance::getAll(@module)
         Returns dict with 'methods', 'classes', 'vars' keys.
         """
-        import inspect
+        from .cssl_types import CSSLInstance
+
         result = {
             'methods': [],
             'classes': [],
             'vars': []
         }
+
+        # Handle CSSL class instances
+        if isinstance(obj, CSSLInstance):
+            result['methods'] = list(obj._class.methods.keys())
+            result['classes'] = [obj._class.name]
+
+            # Separate regular vars from merged class instances
+            for name, member in obj._members.items():
+                if isinstance(member, CSSLInstance):
+                    # Merged class - add to classes list
+                    result['classes'].append(member._class.name)
+                else:
+                    # Regular variable
+                    result['vars'].append(name)
+            return result
+
+        # Handle Python objects
+        import inspect
         for name in dir(obj):
             if not name.startswith('_'):
                 attr = getattr(obj, name, None)
@@ -1106,21 +1197,46 @@ class CSSLBuiltins:
         """Dynamically call a method on an object.
         Usage: instance::call(@module, 'methodName', arg1, arg2)
         """
+        from .cssl_types import CSSLInstance
+
+        # Handle CSSL class instances
+        if isinstance(obj, CSSLInstance):
+            if obj.has_method(method_name):
+                # Need runtime to call the method
+                if self.runtime:
+                    return self.runtime._call_method(obj, obj.get_method(method_name), list(args), kwargs or {})
+            raise RuntimeError(f"Method '{method_name}' not found on CSSL instance")
+
+        # Handle Python objects
         method = getattr(obj, method_name, None)
         if method and callable(method):
             return method(*args, **kwargs)
         raise RuntimeError(f"Method '{method_name}' not found on object")
 
     def builtin_instance_has(self, obj: Any, name: str) -> bool:
-        """Check if object has an attribute.
+        """Check if object has an attribute or method.
         Usage: instance::has(@module, 'methodName')
         """
+        from .cssl_types import CSSLInstance
+
+        # Handle CSSL class instances
+        if isinstance(obj, CSSLInstance):
+            return obj.has_member(name) or obj.has_method(name)
+
+        # Handle Python objects
         return hasattr(obj, name)
 
     def builtin_instance_type(self, obj: Any) -> str:
         """Get the type name of an object.
         Usage: instance::type(@module)
         """
+        from .cssl_types import CSSLInstance
+
+        # Handle CSSL class instances
+        if isinstance(obj, CSSLInstance):
+            return obj._class.name
+
+        # Handle Python objects
         return type(obj).__name__
 
     def builtin_isavailable(self, name_or_obj: Any) -> bool:
@@ -1140,6 +1256,50 @@ class CSSLBuiltins:
         # Otherwise, check if the object is not None (for $name or instance<"name">)
         return name_or_obj is not None
 
+    # ============= Filter Registration Functions =============
+
+    def builtin_filter_register(self, filter_type: str, helper: str, callback: Any) -> bool:
+        """Register a custom filter.
+        Usage: filter::register("mytype", "where", myCallback)
+
+        The callback receives (source, filter_value, runtime) and returns filtered result.
+        Use "*" as helper for catch-all.
+
+        Example:
+            define myFilter(source, value, runtime) {
+                return source + value;
+            }
+            filter::register("custom", "add", myFilter);
+
+            result <==[custom::add=10] 5;  // result = 15
+        """
+        from .cssl_runtime import register_filter
+        register_filter(filter_type, helper, callback)
+        return True
+
+    def builtin_filter_unregister(self, filter_type: str, helper: str) -> bool:
+        """Unregister a custom filter.
+        Usage: filter::unregister("mytype", "where")
+        """
+        from .cssl_runtime import unregister_filter
+        return unregister_filter(filter_type, helper)
+
+    def builtin_filter_list(self) -> list:
+        """List all registered custom filters.
+        Usage: filter::list()
+        Returns list of filter keys like ["mytype::where", "custom::*"]
+        """
+        from .cssl_runtime import get_custom_filters
+        return list(get_custom_filters().keys())
+
+    def builtin_filter_exists(self, filter_type: str, helper: str) -> bool:
+        """Check if a custom filter exists.
+        Usage: filter::exists("mytype", "where")
+        """
+        from .cssl_runtime import get_custom_filters
+        key = f"{filter_type}::{helper}"
+        return key in get_custom_filters()
+
     # ============= Regex Functions =============
 
     def builtin_match(self, pattern: str, string: str) -> Optional[dict]:
@@ -1680,7 +1840,7 @@ class CSSLBuiltins:
 
     def builtin_cso_root(self, path: str = "") -> str:
         """
-        Get absolute path relative to CSO root directory
+        Get absolute path relative to project root directory
         Usage: cso_root('/services/myservice.cssl')
         Returns: Full absolute path to the file
         """
@@ -1729,7 +1889,7 @@ class CSSLBuiltins:
             if os.path.exists(cwd_path):
                 filepath = cwd_path
             else:
-                # Fall back to cso_root for CSO service context
+                # Fall back to cso_root for service context
                 filepath = self.builtin_cso_root(filepath)
 
         # Check file exists
@@ -1923,7 +2083,7 @@ class CSSLBuiltins:
                 if os.path.exists(cwd_path):
                     filepath = cwd_path
                 else:
-                    # Fall back to cso_root for CSO service context
+                    # Fall back to cso_root for service context
                     filepath = self.builtin_cso_root(filepath)
 
             # Check file exists
@@ -2203,6 +2363,38 @@ class CSSLBuiltins:
         from .cssl_types import OpenQuote
         return OpenQuote(db_ref)
 
+    def builtin_vector(self, element_type: str = 'dynamic') -> Any:
+        """Create a vector container.
+
+        Usage: vector<int> myVector; or vector('int')
+        """
+        from .cssl_types import Vector
+        return Vector(element_type)
+
+    def builtin_array(self, element_type: str = 'dynamic') -> Any:
+        """Create an array container.
+
+        Usage: array<string> myArray; or array('string')
+        """
+        from .cssl_types import Array
+        return Array(element_type)
+
+    def builtin_stack(self, element_type: str = 'dynamic') -> Any:
+        """Create a stack container.
+
+        Usage: stack<int> myStack; or stack('int')
+        """
+        from .cssl_types import Stack
+        return Stack(element_type)
+
+    def builtin_map(self, key_type: str = 'dynamic', value_type: str = 'dynamic') -> Any:
+        """Create a map container.
+
+        Usage: map<string, int> myMap; or map('string', 'int')
+        """
+        from .cssl_types import Map
+        return Map(key_type, value_type)
+
     def builtin_openfind(self, combo_or_type: Any, index: int = 0, params: list = None) -> Any:
         """Find open parameter by type or combo space.