sonolus.py 0.3.2__py3-none-any.whl → 0.3.4__py3-none-any.whl

sonolus/script/vec.py

@@ -73,8 +73,20 @@ class Vec2(Record):
         """
         return cls(x=1, y=0)
 
+    @classmethod
+    def unit(cls, angle: float) -> Self:
+        """Return a unit vector (magnitude 1) at a given angle in radians.
+
+        Args:
+            angle: The angle in radians.
+
+        Returns:
+            A new unit vector at the specified angle.
+        """
+        return Vec2(x=cos(angle), y=sin(angle))
+
     @property
-    def magnitude(self) -> Num:
+    def magnitude(self) -> float:
         """Calculate the magnitude (length) of the vector.
 
         Returns:
@@ -83,7 +95,7 @@ class Vec2(Record):
         return (self.x**2 + self.y**2) ** 0.5
 
     @property
-    def angle(self) -> Num:
+    def angle(self) -> float:
         """Calculate the angle of the vector in radians from the positive x-axis.
 
         Returns:
@@ -91,7 +103,7 @@ class Vec2(Record):
         """
         return atan2(self.y, self.x)
 
-    def dot(self, other: Self) -> Num:
+    def dot(self, other: Self) -> float:
         """Calculate the dot product of this vector with another vector.
 
         Args:
@@ -102,11 +114,11 @@ class Vec2(Record):
         """
         return self.x * other.x + self.y * other.y
 
-    def rotate(self, angle: Num) -> Self:
+    def rotate(self, angle: float) -> Self:
         """Rotate the vector by a given angle in radians and return a new vector.
 
         Args:
-            angle: The angle to rotate the vector by, in radians.
+            angle: The angle to rotate the vector by, in radians. Positive angles rotate counterclockwise.
 
         Returns:
             A new vector rotated by the given angle.
@@ -116,11 +128,11 @@ class Vec2(Record):
             y=self.x * sin(angle) + self.y * cos(angle),
         )
 
-    def rotate_about(self, angle: Num, pivot: Self) -> Self:
+    def rotate_about(self, angle: float, pivot: Self) -> Self:
         """Rotate the vector about a pivot by a given angle in radians and return a new vector.
 
         Args:
-            angle: The angle to rotate the vector by, in radians.
+            angle: The angle to rotate the vector by, in radians. Positive angles rotate counterclockwise.
             pivot: The pivot point to rotate about.
 
         Returns:

{sonolus_py-0.3.2.dist-info → sonolus_py-0.3.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sonolus.py
-Version: 0.3.2
+Version: 0.3.4
 Summary: Sonolus engine development in Python
 License-File: LICENSE
 Requires-Python: >=3.12

{sonolus_py-0.3.2.dist-info → sonolus_py-0.3.4.dist-info}/RECORD

@@ -3,7 +3,7 @@ sonolus/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sonolus/backend/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sonolus/backend/blocks.py,sha256=3peyb9eYBy0s53xNVJ1KmK4IgoyVkkwG-lqDQ_VZTHc,18531
 sonolus/backend/excepthook.py,sha256=pqI9gtPBh0mlTgMNqul8bEVO1ARzKb8pNE9EN_CyDpk,994
-sonolus/backend/finalize.py,sha256=vNUGLCUDxNqXGxweNRA1NpRvtij7Tks9to1V_JTs7Jo,4020
+sonolus/backend/finalize.py,sha256=Ab3Z-TdHhQXQ2KAMfQlDy2VYm4rjPpOZxbFonwQ-8Ic,4614
 sonolus/backend/interpret.py,sha256=B0jqlLmEGoyO2mxpcvwRwV17Tq_gOE9wLNt26Q5QOfs,14306
 sonolus/backend/ir.py,sha256=TCDLMvlX2S8emFDQwFVeD2OUC4fnhbrMObgYtoa_7PQ,2845
 sonolus/backend/mode.py,sha256=NkcPZJm8dn83LX35uP24MtQOCnfRDFZ280dHeEEfauE,613
@@ -11,7 +11,7 @@ sonolus/backend/node.py,sha256=eEzPP14jzWJp2xrZCAaPlNtokxdoqg0bSM7xQiwx1j8,1254
 sonolus/backend/ops.py,sha256=7DERBPU6z9Bz3i6UxyLdFTXYcCpvRZVNWw4ZQ-Djwnk,10510
 sonolus/backend/place.py,sha256=jABvLNNE-2pklTcb9WnyfHK8c-tYxn0ObsoLp5LYd5I,4703
 sonolus/backend/utils.py,sha256=BuJHI-qTVn-vYlQkSr4fSDPpgckkiO2RJmwlDXY_KzM,1818
-sonolus/backend/visitor.py,sha256=DyFXhhSMtpn0T0muQZz59pfbCMJtapz59CxctqRGxyk,49315
+sonolus/backend/visitor.py,sha256=zANjR9PkUnWS5XnvA65OnYUSe54hNcad_nb1TFFTVMY,50213
 sonolus/backend/optimize/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sonolus/backend/optimize/allocate.py,sha256=-cpnCQ7S6wH3y-hCUGb2KT5TMuREifhsMXMI0-YtNjY,7380
 sonolus/backend/optimize/constant_evaluation.py,sha256=ozYB__haE2A_L2NBh2H3IT__Z65FBBtbjh6BJfQRC_A,15988
@@ -34,59 +34,59 @@ sonolus/build/level.py,sha256=AjvK4725nqDcg7oGn5kWocBdG-AcirXpku74T7c2epA,673
 sonolus/build/node.py,sha256=gnX71RYDUOK_gYMpinQi-bLWO4csqcfiG5gFmhxzSec,1330
 sonolus/build/project.py,sha256=DhNqgHnm73qKUOhrg1JPlWEL0Vg7VxcGUbNokpMWzVE,6315
 sonolus/script/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-sonolus/script/archetype.py,sha256=3pvTrQbVimNeU9EDO_2RVoqak3EF0D67OEnCcdaWz1w,40548
-sonolus/script/array.py,sha256=RxdZ-2Df-sYhiMT1xMsPJEGX1oCtDIE3TTntRsk56iA,11760
-sonolus/script/array_like.py,sha256=wFw_drg6aPk_17upAl2G2l-i5fE3rzaUtB8kYEkyJEk,8557
+sonolus/script/archetype.py,sha256=pQ_-J85Skf0tLT0YMoc36TUbJgc8t2HGBAzend_qmoI,41425
+sonolus/script/array.py,sha256=8mC2LXEbYgsblkNcSi8elkAjODBYB29iN4A4-Lsfifo,11970
+sonolus/script/array_like.py,sha256=MVFqTH2iKVpwUntMP8sxRICa9tYb9atyDs_6v0FwpNw,9402
 sonolus/script/bucket.py,sha256=YFSyKS4ZngxerBlKwFBSCRAVewgQdwZ1-NqfPKcPZxI,7519
-sonolus/script/containers.py,sha256=PXwixFp1k1gqjp-gMfnlE1IadEfavFzAS99XH8kaw8Q,17640
-sonolus/script/debug.py,sha256=JIMcGD6cQVWtIw3IIhq-5WenZZu0iArH6SAS1-XfR_8,5076
+sonolus/script/containers.py,sha256=-6QooG0vIXF3fmP97Lxada7Jklm6sXQFwkevGzVNo7s,18403
+sonolus/script/debug.py,sha256=gyOXpduQwKhUrNZDoD_tODp3h6zIQ0yfZk7tKvVQ9x4,5136
 sonolus/script/easing.py,sha256=7zaDKIfM_whUpb4FBz1DAF4NNG2vk_nDjl8kL2Y90aU,11396
 sonolus/script/effect.py,sha256=V9bJvMzs1O4C1PjTOKgsAXov-l4AnDb2h38-DzmeWpI,5838
-sonolus/script/engine.py,sha256=BhhQTrHuGAAAD6JPQ3R0jvHdimwW83PPghEIdAdtGMA,10683
+sonolus/script/engine.py,sha256=etI9dJsQ7V9YZICVNZg54WqpLijPxG8eTPHiV-_EiG8,10687
 sonolus/script/globals.py,sha256=gUvSbxXW1ZOsyQF6qb5iMRnW-eRrg07rWOK1PAYRwsE,9741
-sonolus/script/instruction.py,sha256=PNfxC1dhT_hB0BxhDV3KXMn_kKxfI0t1iZmg8m6ddMU,6725
-sonolus/script/interval.py,sha256=IYNgJx0ngREnEVu_yMAu0MrA_Q7mZuToT8U3fbdb3Sc,9122
+sonolus/script/instruction.py,sha256=GKaYu6GwBLtbgj1nJilD6O2ebRRdmwHZvhYeVHbHcUc,6721
+sonolus/script/interval.py,sha256=IhJZOuhivZZS-9nX_40ksIUPYICpTcHkekxCyo-WllE,11203
 sonolus/script/iterator.py,sha256=wH6IM3ozLuMtCJZzhahIN3o2ykwUzDftU7ylbWo2UF8,4575
 sonolus/script/level.py,sha256=wR23xk-NOcW_JMRb3R12sqIXCLSZL-7cM3y7IpMF1J0,6333
 sonolus/script/metadata.py,sha256=ttRK27eojHf3So50KQJ-8yj3udZoN1bli5iD-knaeLw,753
-sonolus/script/num.py,sha256=6un0Vdaporn0Ft_T71FlUAY57IFjJkCdio91e7FV6KU,15130
+sonolus/script/num.py,sha256=GplnvW11ZyC-bXLdk_RsRnupc__3-xNeduSpxijwNM8,15382
 sonolus/script/options.py,sha256=OqvIPgdHbj03Ffzn857R_SrSJVUstrGy8o7Em6vv0y4,9419
 sonolus/script/particle.py,sha256=oeVQF01xOeW2BEn04ZK1ZOP2HGvQzxBJCpITFjy9woQ,8353
-sonolus/script/pointer.py,sha256=IH2_a0XE76uG_UyYM9jAYIf7qZ5LhUNc9ksXDIvAPZA,1511
+sonolus/script/pointer.py,sha256=FoOfyD93r0G5d_2BaKfeOT9SqkOP3hq6sqtOs_Rb0c8,1511
 sonolus/script/printing.py,sha256=mNYu9QWiacBBGZrnePZQMVwbbguoelUps9GiOK_aVRU,2096
 sonolus/script/project.py,sha256=jLndgGJHdkqFYe-lDl_IzTjQ4gOSuy80en8WoSWXnB8,3340
-sonolus/script/quad.py,sha256=QgA4CdgLPGm2MtANKZPpxaM0qyh3DjxcXZi3D2QuLQs,10213
-sonolus/script/record.py,sha256=ZgQPmkA1GGoQ7aVpMB2xQ3ju4cyTru7nzEVl76P6dV0,12356
-sonolus/script/runtime.py,sha256=8UOedRhtnLQofChpApS-DHZh0VjEWBBktWsNaEubatQ,32245
+sonolus/script/quad.py,sha256=wt0siM3SWPyQ2JEUP6sy_jVArZ62tLZjT-0ZOWPIcLw,11185
+sonolus/script/record.py,sha256=1NeLkg-gufOwcUY9-B4zr8JzgzxINfUB5j9CYLrpMig,12513
+sonolus/script/runtime.py,sha256=XaS3op1BewSQchIffbJoz8WWw-prqk1PqBx2hdI3AMY,32971
 sonolus/script/sprite.py,sha256=CMcRAZ2hejXnaBmY2_n1_rj6hGOgPP5zEW-BpyaEVOY,16256
-sonolus/script/stream.py,sha256=S6ukJ251EHQaSYxuqqYa0BO_LGImYgNqd512rc_l_vA,24062
+sonolus/script/stream.py,sha256=G7oBMVvnDFIpivGNjKixB1OYVwDOkSZbQmc_UvNgg30,24242
 sonolus/script/text.py,sha256=wxujIgKYcCfl2AD2_Im8g3vh0lDEHYwTSRZg9wsBPEU,13402
 sonolus/script/timing.py,sha256=ZR0ypV2PIoDCMHHGOMfCeezStCsBQdzomdqaz5VKex0,2981
-sonolus/script/transform.py,sha256=qtqh_Dpom698VrkKeMZLD3DjWtd3utkqx_nLrrIyWyY,20740
+sonolus/script/transform.py,sha256=BKAokYC1EmyPcdlwapd5P1fA90LwVfJYrkDNDc4NHJ0,20904
 sonolus/script/ui.py,sha256=DYPGWIjHj1IFPxW1zaEuIUQx0b32FJPXtiwCvrtJ6oo,7528
 sonolus/script/values.py,sha256=woSW3we5OZZ1IaO3Qr0OAs_yuIpAzGw_IjwELKQHzv4,1469
-sonolus/script/vec.py,sha256=4ntfJ96zxKR-nVZluUgHd-Ud4vNfButfiv7EsroZxfE,7002
+sonolus/script/vec.py,sha256=lFwMADvBYnNHkh7ejjNPRBKrFrfb1rgaVCVsx6x4Juw,7416
 sonolus/script/internal/__init__.py,sha256=T6rzLoiOUaiSQtaHMZ88SNO-ijSjSSv33TKtUwu-Ms8,136
-sonolus/script/internal/builtin_impls.py,sha256=3e1jzDtyyB1QiCqkp4bRhLnnTMlviBi0QjKvhYwd3q8,8209
+sonolus/script/internal/builtin_impls.py,sha256=VDeBpnLwu6v_r53qiXjgA1NF1aaBm9GTxP1XoWGkSLM,8569
 sonolus/script/internal/callbacks.py,sha256=vWzJG8uiJoEtsNnbeZPqOHogCwoLpz2D1MnHY2wVV8s,2801
 sonolus/script/internal/constant.py,sha256=k4kIBoy-c74UbfUR7GKzyTT6syhE-lSRJfw0nGuc8ZY,3904
-sonolus/script/internal/context.py,sha256=v6DbyqqhieSajcIYf__he4gFSB7UpCMljZaR3SYewzM,15473
+sonolus/script/internal/context.py,sha256=aJUXAsL9KlO7i5jVvuWsbHkNi8o_YevtoWyzaUdIYp4,15561
 sonolus/script/internal/descriptor.py,sha256=XRFey-EjiAm_--KsNl-8N0Mi_iyQwlPh68gDp0pKf3E,392
 sonolus/script/internal/dict_impl.py,sha256=alu_wKGSk1kZajNf64qbe7t71shEzD4N5xNIATH8Swo,1885
 sonolus/script/internal/error.py,sha256=ZNnsvQVQAnFKzcvsm6-sste2lo-tP5pPI8sD7XlAZWc,490
 sonolus/script/internal/generic.py,sha256=F0-cCiRNGTaUJvYlpmkiOsU3Xge_XjoBpBwBhH_qS_s,7577
 sonolus/script/internal/impl.py,sha256=0uIZ9UtZYqKbsvp2XKo-aVIzkiA8MRbiPIOt0OMmxVo,3018
 sonolus/script/internal/introspection.py,sha256=SL2zaYjid0kkcj6ZbFLIwhgh7WKZBaAHhlbSJGr6PWs,974
-sonolus/script/internal/math_impls.py,sha256=Xk7tLMnV2npzPJWtHlspONQHt09Gh2YLdHhAjx4jkdE,2320
-sonolus/script/internal/native.py,sha256=XKlNnWSJ-lxbwVGWhGj_CSSoWsVN18imqT5sAsDJT1w,1551
+sonolus/script/internal/math_impls.py,sha256=nHSLgA7Tcx7jY1p07mYBCeSRmVx713bwdNayCIcaXSE,2652
+sonolus/script/internal/native.py,sha256=rbQIpzE1Zec6IoCiQVC3kW9dJbEZmaIjDkVzrBeXQfk,1596
 sonolus/script/internal/random.py,sha256=6Ku5edRcDUh7rtqEEYCJz0BQavw69RALsVHS25z50pI,1695
-sonolus/script/internal/range.py,sha256=lrTanQFHU7RuQxSSPwDdoC30Y8FnHGxcP1Ahditu3zU,2297
+sonolus/script/internal/range.py,sha256=OMYsGUB43K7jwX1sbIPnJBDk9j0gL1XPr81QUVok-C4,3370
 sonolus/script/internal/simulation_context.py,sha256=jUgNxCOEc_b99w1yFyVz0nVb6rgkEsyuCBvcYxq34Vk,4819
 sonolus/script/internal/transient.py,sha256=d6iYhM9f6DPUX5nkYQGm-x0b9XEfZUmB4AtUNnyhixo,1636
-sonolus/script/internal/tuple_impl.py,sha256=BVImJ5q8E9APMtSnHYnbFh6x8c36yktepewnnaQVWg4,3515
-sonolus/script/internal/value.py,sha256=gQVNQD_xGpgrN4-UXFDmWRZCJCe8wPZ_wYv4QoPRJkM,5379
-sonolus_py-0.3.2.dist-info/METADATA,sha256=IcdTSXe5sjwmMh50kkhB2JZVSAU3GUUjqQzQFh_yGm0,302
-sonolus_py-0.3.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-sonolus_py-0.3.2.dist-info/entry_points.txt,sha256=oTYspY_b7SA8TptEMTDxh4-Aj-ZVPnYC9f1lqH6s9G4,54
-sonolus_py-0.3.2.dist-info/licenses/LICENSE,sha256=JEKpqVhQYfEc7zg3Mj462sKbKYmO1K7WmvX1qvg9IJk,1067
-sonolus_py-0.3.2.dist-info/RECORD,,
+sonolus/script/internal/tuple_impl.py,sha256=DPNdmmRmupU8Ah4_XKq6-PdT336l4nt15_uCJKQGkkk,3587
+sonolus/script/internal/value.py,sha256=bfooiA5cMlZOCKqqchnUGNdJJc6-ec2jHoLsDZjbU_g,5379
+sonolus_py-0.3.4.dist-info/METADATA,sha256=B9QIp4ebnYp4YO5F7TXa3bP-MHKoJJQ3cMMlgrA0JF4,302
+sonolus_py-0.3.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+sonolus_py-0.3.4.dist-info/entry_points.txt,sha256=oTYspY_b7SA8TptEMTDxh4-Aj-ZVPnYC9f1lqH6s9G4,54
+sonolus_py-0.3.4.dist-info/licenses/LICENSE,sha256=JEKpqVhQYfEc7zg3Mj462sKbKYmO1K7WmvX1qvg9IJk,1067
+sonolus_py-0.3.4.dist-info/RECORD,,