refactor: enable t4_devkit.common to simplify imports

docs/apis/common.md

@@ -1,13 +1 @@
 # `common`
-
-<!-- prettier-ignore-start -->
-::: t4_devkit.common.converter
-
-::: t4_devkit.common.geometry
-
-::: t4_devkit.common.io
-
-::: t4_devkit.common.serialize
-
-::: t4_devkit.common.timestamp
-<!-- prettier-ignore-end -->

docs/tutorials/customize.md

@@ -6,7 +6,7 @@ You can crate a schema containing the specified table data with a new token usin
 
 ```python
 >>> from t4_devkit.schema import Attribute
->>> from t4_devkit.common.serialize import serialize_dataclass
+>>> from t4_devkit.common import serialize_dataclass
 >>>
 >>> # schema data except of the unique identifier token
 >>> data = {
@@ -58,7 +58,7 @@ from __future__ import annotations
 from attrs import define, field
 
 from t4_devkit.schema import SCHEMAS, SchemaName, SchemaBase
-from t4_devkit.common.io import load_json
+from t4_devkit.common import load_json
 
 __all__ = ["CustomAttribute"]
 

docs/tutorials/initialize.md

@@ -157,7 +157,7 @@ An `attribute` is a property of an instance that may change throughout different
 ```
 
 <!-- prettier-ignore-start -->
-??? WARNING
+!!! WARNING
     Expected `level` values in `visibility` are as below:
 
     <!-- markdownlint-disable MD046 -->

docs/tutorials/sanity.md

@@ -6,9 +6,8 @@
 
 About the defined rules, please refer to [requirement.md](../schema/requirement.md).
 
-```python
-from t4_devkit.common.io import save_json
-from t4_devkit.common.serialize import serialize_dataclass
+```python title="main.py"
+from t4_devkit.common import save_json, serialize_dataclass
 from t4_devkit.sanity import sanity_check, print_sanity_result
 
 
@@ -30,7 +29,7 @@ All checkers must follow:
 - Override the `check() -> list[Reason] | None` method to perform the specific check.
 - Register the checker using `CHECKERS.register()` decorator.
 
-```python
+```python title="str000.py"
 from __future__ import annotations
 
 from typing import TYPE_CHECKING

t4_devkit/common/__init__.py

@@ -0,0 +1,7 @@
+from __future__ import annotations
+
+from .converter import *  # noqa
+from .geometry import *  # noqa
+from .io import *  # noqa
+from .serialize import *  # noqa
+from .timestamp import *  # noqa

t4_devkit/common/serialize.py

@@ -8,6 +8,9 @@
 from pyquaternion import Quaternion
 
 
+__all__ = ["serialize_dataclasses", "serialize_dataclass"]
+
+
 def serialize_dataclasses(data: list[Any]) -> list[dict]:
     """Serialize list of attrs' dataclasses into list of dict.
 

t4_devkit/common/timestamp.py

@@ -8,6 +8,9 @@
     from t4_devkit.typing import ScalarLike
 
 
+__all__ = ["microseconds2seconds", "seconds2microseconds"]
+
+
 @deprecated("Please use `microseconds2seconds(...)` instead.")
 def us2sec(timestamp: ScalarLike) -> float:
     """Convert timestamp from micro seconds [us] to seconds [s].