VERSION: 0.13.0 - Buffer, U8, U64, bit ops, UTF-8 Iterator, hex integrals, MPL-2.0

Author: Florian Thake

COPYRIGHT.TXT

@@ -3,11 +3,13 @@ Except where otherwise noted all files included are copyrighted by Florian Thake
 Copyright (C) 2024 Florian Thake <contact |at| tea-age.solutions>.
 
 
-The TeaScript C++ Library as well as the TeaScript Host Application
-are licensed under the GNU AFFERO GENERAL PUBLIC LICENSE Version 3
-See included LICENSE.TXT or <https://www.gnu.org/licenses/>.
-If you cannot or don't want use this AGPL license, 
-you may ask for a different license via the contact information below.
+The TeaScript C++ Library 
+is licensed under the Mozilla Public License 2.0
+See included LICENSE.TXT or <https://www.mozilla.org/en-US/MPL/2.0/>
+
+The TeaScript Host Application
+is licensed under the GNU AFFERO GENERAL PUBLIC LICENSE Version 3
+See included LICENSE_AGPL.TXT or <https://www.gnu.org/licenses/>.
 
 
 Some distribution packages (e.g. the TeaScript Host for Linux) might use other (A)GPL software.
@@ -26,7 +28,13 @@ All files marked with
 SPDX-License-Identifier: AGPL-3.0-only 
 are licensed under the GNU AFFERO GENERAL PUBLIC LICENSE Version 3
 
-See included LICENSE.TXT or <https://www.gnu.org/licenses/>.
+See included LICENSE_AGPL.TXT or <https://www.gnu.org/licenses/>.
+
+All files marked with 
+SPDX-License-Identifier: MPL-2.0
+are licensed under the Mozilla Public License 2.0
+
+See included LICENSE.TXT or <https://www.mozilla.org/en-US/MPL/2.0/>
 
 All files marked with 
 SPDX-License-Identifier: MIT

Deprecation_and_Breaking_Changes.txt

@@ -1,93 +1,72 @@
 TeaScript Breaking Changes in the actual release
 =================================================
 
-    Default constness
-    -----------------
-    Default constness of function parameters changed from mutable (def) to const for copy assigned parameters.
-    E.g.: func sum( a, b ) { a + b } // a and b are const by default now!
-    
-    This does not effect parameters which are shared assigned.
-    E.g.: func swap( a @=, b @= ) { const tmp := a, a:= b, b := tmp }  // a and b are still mutable by default.
-    
-    As before you can always explicit set the constness/mutability.
-    E.g.: func test( const a_is_const @= , def b_is_mutable )
-    
-    This version has several ways to enable the old behavior:
-    
-    1.) For the Host Application launch your scripts with
-        --old-mutable-parameters
-        E.g.:
-        TeaScript.exe --old-mutable-parameters  my_script.tea arg1 arg2
-    
-    2.) For the C++ Library use the high level API of class Engine:
-        void ActivateDeprecatedDefaultMutableParameters() noexcept;
-        Please, read also the comments.
-        
-    3.) For C++ Library low level programming:
-        Overwrite the TeaScript language dialect in the Parser:
-        void OverwriteDialect( Dialect const dialect ) noexcept;
-        Please, read also the comments there and in teascript/Dialect.hpp
-        
-    4.) Compile the Library and/or Host Application with 
-        #define TEASCRIPT_DEFAULT_CONST_PARAMETERS  false
-        You can do this from inside Dialect.hpp or define it outside (e.g. your project settings/before include)
-        Please, read also the comments in teascript/Dialect.hpp
-        
-    Point 1 and 2 will be deprecated and removed in later versions!
-    Point 3 has experimental state for now. (means API is not promoted to official and might be changed/removed.)
-    All of the points creating a legacy TeaScript language dialect which is not the official standard language!
+    Changes in CoreLibrary functionality
+    ------------------------------------
+    strat() / CoreLibrary::StrAt() will now return strings of length [0..4] depending on the utf-8 code point char amount.
+    It will always return a full and complete utf-8 encoded glyph. If the wanted pos is in the middle
+    of an utf-8 code point this complete utf-8 code point will be returned.
+    
+    readtextfile / CoreLibrary::ReadTextFile() will now do a complete UTF-8 validation of the read input.
+    Also, it will not throw anymore but return Bool(false).
+
+
+    Changes on C++ API level
+    ------------------------------------
+    Util.hpp is splitted in 3 files: Util.hpp, UtilContent.hpp, UtilInternal.hpp.
+    Most likely you still only need Util.hpp.
+    
+    ASTNode::Eval() has been made const.
 
+    Parser::Num() throws exception::parsing_error instead of std::out_of_range
 
+    exception::bad_value_cast now inherits from exception::runtime_error (w. SoruceLocation) instead of std::bad_any_cast
+    
+    Engine::AddVar/AddConst w. unsigned int overload now adds a U64 instead of I64
+    (NOTE: If a future U32/I32 will be added this overloads (and those for int) will change again/as well!)
+    
+    Tuple is first class citizen now. 
+    This must be taken into account for a visitor applied to ValueObject::Visit.
+    
+
     Visibility of Core Library functions
     ------------------------------------
     The following Core Library functions moved up to Level CoreReduced:
 
-    The following Core Library functions moved up to Level Core:
+    _f64toi64
 
-    eval_file
+    The following Core Library functions moved up to Level Core:
 
     The following Core Library functions moved up to Level Util:
 
     The following Core Library functions moved up to Level Full:
-    
-    trunc               (check _trunc from LevelUtil)
-    ceil
-    floor
-    sqrt                (check _sqrt from LevelUtil)
-    file_copy
-    file_copy_newer
-    readtextfile
-    writetextfile
-    create_dir
-    path_delete
-    file_exists         (check path_exists and file_size from LevelUtil)
-    readtomlfile
-    
-    
-    
-    libfmt preferred over C++23
-    ---------------------------
-    If you compile in C++23 mode with the <print> header (for std::vprint_unicode()) 
-    but in your include path is a libfmt (#include "fmt/format.h") then
-    libfmt will be preferred over the C++23 variant (because more features).
-    You can disable libfmt with #define TEASCRIPT_DISABLE_FMTLIB         1
-    in teascript/Print.hpp
-
 
 
 TeaScript list of deprecated parts
 =================================================
 
     The following deprecated parts have been finally removed from this release:
 
-    virtual void CoreLibrary::Bootstrap( Context &, bool );
-    use the new one instead: virtual void Bootstrap( Context &rContext, config::eConfig const config )
+    bool Parser::Int( Content & )
+    use Integer( Content & ) or Num( Content &, bool ) instead.
 
+    func eval( sth_unspecified )  from TeaScript Core Library (use the not confusing _eval( code_string ) variant instead)
 
+    
     The following parts are now deprecated and will be removed in some future release:
 
-    func eval( sth_unspecified )  from TeaScript Core Library (use the not confusing _eval( code_string ) variant instead)
+    Engine::ActivateDeprecatedDefaultMutableParameters()
+    Please, change your script code to explicit mutable parameters with 'def' keyword.
+    More deatails are available in the comment.
 
-    bool Parser::Int( Content & )
-    use Integer( Content & ) or Num( Content &, bool ) instead.
+    CoreLibrary::DoubleToLongLong()
+    This was the implementation for _f64toi64. In C++ just use a static_cast<long long>!
+    
+    ArithmeticFactory::ApplyBinOp()|ApplyUnOp()
+    Please, use ArithmeticFactory::ApplyBinaryOp() and ArithmeticFactory::ApplyUnaryOp() instead.
+
+    Context::BulkAdd()
+    Please, use InjectVars() instead.
 
+    Context( VariableStorage const &init, TypeSystem && rMovedSys, bool const booting )
+    Please, uses a different constructor instead.

Known_Issues.txt

@@ -3,19 +3,12 @@ TeaScript Known Issues
 
 Beside feature incompleteness there are the following known issues which will be fixed in a later (pre-)release.
 NOTE: The numbers stay same, solved items will (usually) be removed in the next release from this list.
+     
 
-1.) [PLATFORM: any] Solved in 0.12 (floating point literals can use decimal point and exponent the same time, e.g.: 123.456e-10 )
+3.) [PLATFORM: any] Solved in 0.13 (explicit cast to variuos number types is posible now with the as operator
+                                    e.g., n as i64 or x as f64 )
 
 
-2.) [PLATFORM: any] Solved in 0.12 (floating point to string conversion now uses default conversion via std::format/fmt::to_string)
-    
-    
-3.) [PLATFORM: any]
-    Actually, there are neither implicit number type conversions nor any cast operators.
-    For convert f64 to i64 you must use the function _f64toi64 (or to_i64).
-    For convert i64 to f64 you can either use to_f64 or simply add 0.0 for f64 promotion.
-    
-
 5.) [PLATFORM: Windows]
     Echo'ed(!) input of Unicode might be broken on Windows for the case if the Unicode glyph is 
     assembled as a surrogate pair in it's UTF-16 representation. This is a bug (or missing feature)
@@ -57,5 +50,5 @@ NOTE: The numbers stay same, solved items will (usually) be removed in the next
      WORKAROUND: since 0.11.0 Subscript Operator is implemented, use tup[0].1 or tup[0][1]  as a workaround.
 
 
-12.) [PLATFORM: any] Solved in 0.12 (trunc does not work with the full range of f64 (but only with the range of i64))
+13.) -