nowfycore 1.0.0__tar.gz

nowfycore-1.0.0/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: nowfycore
+Version: 1.0.0
+Summary: Nowfy core runtime package (pure layer)
+Author: AGeekApple
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+Requires-Dist: yt-dlp
+Requires-Dist: ytmusicapi
+
+# nowfycore
+
+Pure Python core runtime for Nowfy.
+
+## Local build
+
+```bash
+python -m build packages/nowfycore
+```
+
+Artifacts:
+- `packages/nowfycore/dist/nowfycore-1.0.0-py3-none-any.whl`
+- `packages/nowfycore/dist/nowfycore-1.0.0.tar.gz`
+
+## Release helper
+
+```bash
+python packages/nowfycore/scripts/release_nowfycore.py
+python packages/nowfycore/scripts/release_nowfycore.py --upload --repository pypi
+```
+
+Optional:
+- `--repository testpypi`
+- `--skip-existing`
+
+## Runtime usage in Nowfy plugin
+
+`nowfy.plugin` uses:
+
+```python
+__requirements__ = ["nowfycore>=1.0.0"]
+```
+
+So only `nowfy.plugin` needs to be installed by the user; core runtime is resolved through requirements.

nowfycore-1.0.0/README.md

@@ -0,0 +1,34 @@
+# nowfycore
+
+Pure Python core runtime for Nowfy.
+
+## Local build
+
+```bash
+python -m build packages/nowfycore
+```
+
+Artifacts:
+- `packages/nowfycore/dist/nowfycore-1.0.0-py3-none-any.whl`
+- `packages/nowfycore/dist/nowfycore-1.0.0.tar.gz`
+
+## Release helper
+
+```bash
+python packages/nowfycore/scripts/release_nowfycore.py
+python packages/nowfycore/scripts/release_nowfycore.py --upload --repository pypi
+```
+
+Optional:
+- `--repository testpypi`
+- `--skip-existing`
+
+## Runtime usage in Nowfy plugin
+
+`nowfy.plugin` uses:
+
+```python
+__requirements__ = ["nowfycore>=1.0.0"]
+```
+
+So only `nowfy.plugin` needs to be installed by the user; core runtime is resolved through requirements.

nowfycore-1.0.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "nowfycore"
+version = "1.0.0"
+description = "Nowfy core runtime package (pure layer)"
+readme = "README.md"
+requires-python = ">=3.9"
+authors = [{name = "AGeekApple"}]
+dependencies = [
+  "requests",
+  "yt-dlp",
+  "ytmusicapi",
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

nowfycore-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

nowfycore-1.0.0/src/nowfycore/__init__.py

@@ -0,0 +1,87 @@
+from .api import get_nowfy_core_api, NowfyCoreAPI, NowfyCoreBackendMixin
+from .language import SUPPORTED_LANGS, get_plugin_lang_code, get_plugin_lang_index, normalize_plugin_lang_index
+from .state import CoreState
+from .services import get_bio_feature_services
+from .flags import is_addon_enabled, is_theme_enabled
+from .bridge import invoke_action
+from .corekeys import CORE_SETTINGS_KEYS, export_core_settings_from_plugin, import_core_settings_to_plugin
+from .trackhub import append_track_hub_style_selector, build_track_hub_subfragment_items
+from .panel import (
+    on_panel_drawer_toggle,
+    on_panel_disable_logs_toggle,
+    on_lab_nowplaying_pill_toggle,
+    on_lab_send_haptic_toggle,
+)
+from .cache import clear_cache_data
+from .themes import inject_core_theme_multiselect
+from .about import animate_opening_avatar, inject_about_support_rich_header
+from .injections import (
+    inject_services_cards_custom,
+    inject_home_services_entry_custom,
+    inject_statsfm_profile_custom,
+)
+from .ui_controls import (
+    get_nowtab_control_style,
+    apply_nowtab_control_modern_ui,
+    update_nowtab_control_modern_state,
+    inject_track_hub_source_slide,
+    inject_nowtab_control_style_slide,
+    inject_vinify_logo_position_radios,
+    inject_vinify_cover_shape_slide,
+    inject_nowfy_pulse_style_slide,
+    inject_custom_cover_selector,
+    on_custom_cover_select,
+    on_custom_cover_toggle,
+)
+from .trackhub_ui import render_track_hub_box_cell, clear_track_hub_box_cell
+from .tab_actions import send_tab_track_download, send_tab_music_preview
+from .welcome import maybe_show_nowfy_welcome_sheet
+from .translations import get_nowfy_translations
+
+__all__ = [
+    "get_nowfy_core_api",
+    "NowfyCoreAPI",
+    "NowfyCoreBackendMixin",
+    "SUPPORTED_LANGS",
+    "get_plugin_lang_code",
+    "get_plugin_lang_index",
+    "normalize_plugin_lang_index",
+    "CoreState",
+    "get_bio_feature_services",
+    "is_addon_enabled",
+    "is_theme_enabled",
+    "invoke_action",
+    "CORE_SETTINGS_KEYS",
+    "export_core_settings_from_plugin",
+    "import_core_settings_to_plugin",
+    "append_track_hub_style_selector",
+    "build_track_hub_subfragment_items",
+    "on_panel_drawer_toggle",
+    "on_panel_disable_logs_toggle",
+    "on_lab_nowplaying_pill_toggle",
+    "on_lab_send_haptic_toggle",
+    "clear_cache_data",
+    "inject_core_theme_multiselect",
+    "animate_opening_avatar",
+    "inject_about_support_rich_header",
+    "inject_services_cards_custom",
+    "inject_home_services_entry_custom",
+    "inject_statsfm_profile_custom",
+    "get_nowtab_control_style",
+    "apply_nowtab_control_modern_ui",
+    "update_nowtab_control_modern_state",
+    "inject_track_hub_source_slide",
+    "inject_nowtab_control_style_slide",
+    "inject_vinify_logo_position_radios",
+    "inject_vinify_cover_shape_slide",
+    "inject_nowfy_pulse_style_slide",
+    "inject_custom_cover_selector",
+    "on_custom_cover_select",
+    "on_custom_cover_toggle",
+    "render_track_hub_box_cell",
+    "clear_track_hub_box_cell",
+    "send_tab_track_download",
+    "send_tab_music_preview",
+    "maybe_show_nowfy_welcome_sheet",
+    "get_nowfy_translations",
+]

nowfycore-1.0.0/src/nowfycore/about.py

@@ -0,0 +1,165 @@
+def animate_opening_avatar(plugin, avatar_view, from_y_dp=20, duration_ms=620):
+    try:
+        if avatar_view is None:
+            return False
+        AndroidUtilities = None
+        try:
+            from hook_utils import find_class
+
+            AndroidUtilities = find_class("org.telegram.messenger.AndroidUtilities")
+        except Exception:
+            AndroidUtilities = None
+        try:
+            if AndroidUtilities is not None:
+                avatar_view.setCameraDistance(float(AndroidUtilities.dp(800)))
+        except Exception:
+            pass
+        try:
+            if AndroidUtilities is not None:
+                avatar_view.setTranslationY(float(AndroidUtilities.dp(int(from_y_dp or 20))))
+        except Exception:
+            pass
+        try:
+            avatar_view.setAlpha(0.0)
+        except Exception:
+            pass
+        try:
+            avatar_view.setRotationY(-120.0)
+        except Exception:
+            pass
+        try:
+            avatar_view.animate().cancel()
+        except Exception:
+            pass
+        try:
+            avatar_view.animate().translationY(0.0).alpha(1.0).rotationY(0.0).setDuration(int(duration_ms or 620)).start()
+        except Exception:
+            pass
+        return True
+    except Exception:
+        return False
+
+
+def _build_support_project_rich_item(plugin, description_text=None):
+    try:
+        from org.telegram.messenger import ApplicationLoader
+        from org.telegram.ui.Components import UItem
+        from android.widget import LinearLayout, TextView
+        from android.view import Gravity
+        from android.util import TypedValue
+        from android.graphics.drawable import GradientDrawable
+
+        Theme = None
+        AndroidUtilities = None
+        get_last_fragment = None
+        tr_fn = None
+        try:
+            import nowfy as nowfy_mod
+
+            Theme = getattr(nowfy_mod, "Theme", None)
+            AndroidUtilities = getattr(nowfy_mod, "AndroidUtilities", None)
+            get_last_fragment = getattr(nowfy_mod, "get_last_fragment", None)
+            tr_fn = getattr(nowfy_mod, "tr", None)
+        except Exception:
+            pass
+
+        ctx = None
+        try:
+            frag = get_last_fragment() if callable(get_last_fragment) else None
+            ctx = frag.getParentActivity() if frag and frag.getParentActivity() else ApplicationLoader.applicationContext
+        except Exception:
+            ctx = ApplicationLoader.applicationContext
+        if ctx is None:
+            return None
+
+        rich = LinearLayout(ctx)
+        rich.setOrientation(LinearLayout.VERTICAL)
+        rich.setGravity(Gravity.START)
+        try:
+            if AndroidUtilities is not None:
+                rich.setPadding(AndroidUtilities.dp(14), AndroidUtilities.dp(14), AndroidUtilities.dp(14), AndroidUtilities.dp(14))
+        except Exception:
+            pass
+        try:
+            bg = GradientDrawable()
+            if AndroidUtilities is not None:
+                bg.setCornerRadius(AndroidUtilities.dp(16))
+            bg.setColor(0x162B3E5A)
+            rich.setBackground(bg)
+        except Exception:
+            pass
+
+        desc = TextView(ctx)
+        txt = str(description_text or "").strip()
+        if not txt:
+            try:
+                txt = str(plugin.tr("about_plugin_description") if hasattr(plugin, "tr") else "")
+            except Exception:
+                txt = ""
+        if not txt:
+            try:
+                txt = str(tr_fn("about_plugin_description") if callable(tr_fn) else "")
+            except Exception:
+                txt = ""
+        if not txt:
+            txt = "Support the project."
+        desc.setText(txt)
+        desc.setTextSize(TypedValue.COMPLEX_UNIT_DIP, 13)
+        desc.setGravity(Gravity.START)
+        try:
+            if Theme is not None:
+                desc.setTextColor(Theme.getColor(Theme.key_windowBackgroundWhiteGrayText))
+            else:
+                desc.setTextColor(0xFFD2DCEB)
+        except Exception:
+            pass
+        rich.addView(desc)
+        return UItem.asCustom(rich)
+    except Exception:
+        return None
+
+
+def inject_about_support_rich_header(plugin, activity, items):
+    try:
+        if activity is None or items is None:
+            return False
+        desc_txt = ""
+        try:
+            desc_txt = str(plugin.tr("about_plugin_description") if hasattr(plugin, "tr") else "")
+        except Exception:
+            desc_txt = ""
+
+        remove_idxs = []
+        for i in range(items.size()):
+            try:
+                it = items.get(i)
+                txt = ""
+                try:
+                    if hasattr(plugin, "_get_uitem_text"):
+                        txt = str(plugin._get_uitem_text(it) or "").strip()
+                except Exception:
+                    txt = ""
+                if desc_txt and txt == desc_txt:
+                    remove_idxs.append(i)
+            except Exception:
+                pass
+        for i in reversed(remove_idxs):
+            try:
+                items.remove(i)
+            except Exception:
+                pass
+
+        rich_item = _build_support_project_rich_item(plugin, desc_txt)
+        if rich_item is not None:
+            try:
+                rich_item.object2 = "__about_support_rich__"
+            except Exception:
+                pass
+            try:
+                items.add(0, rich_item)
+            except Exception:
+                items.add(rich_item)
+            return True
+        return False
+    except Exception:
+        return False

nowfycore-1.0.0/src/nowfycore/api.py

@@ -0,0 +1,268 @@
+from .language import (
+    get_plugin_lang_code as _get_plugin_lang_code,
+    get_plugin_lang_index as _get_plugin_lang_index,
+    normalize_plugin_lang_index as _normalize_plugin_lang_index,
+)
+from .state import CoreState
+from .services import get_bio_feature_services as _get_bio_feature_services
+from .flags import is_addon_enabled as _is_addon_enabled, is_theme_enabled as _is_theme_enabled
+from .bridge import invoke_action as _invoke_action
+from .corekeys import (
+    export_core_settings_from_plugin as _export_core_settings_from_plugin,
+    import_core_settings_to_plugin as _import_core_settings_to_plugin,
+)
+from .trackhub import build_track_hub_subfragment_items as _build_track_hub_subfragment_items
+from .themes import inject_core_theme_multiselect as _inject_core_theme_multiselect
+from .panel import (
+    on_panel_drawer_toggle as _on_panel_drawer_toggle,
+    on_panel_disable_logs_toggle as _on_panel_disable_logs_toggle,
+    on_lab_nowplaying_pill_toggle as _on_lab_nowplaying_pill_toggle,
+    on_lab_send_haptic_toggle as _on_lab_send_haptic_toggle,
+)
+from .cache import clear_cache_data as _clear_cache_data
+from .about import (
+    animate_opening_avatar as _animate_opening_avatar,
+    inject_about_support_rich_header as _inject_about_support_rich_header,
+)
+from .injections import (
+    inject_services_cards_custom as _inject_services_cards_custom,
+    inject_home_services_entry_custom as _inject_home_services_entry_custom,
+    inject_statsfm_profile_custom as _inject_statsfm_profile_custom,
+)
+from .ui_controls import (
+    get_nowtab_control_style as _get_nowtab_control_style,
+    apply_nowtab_control_modern_ui as _apply_nowtab_control_modern_ui,
+    update_nowtab_control_modern_state as _update_nowtab_control_modern_state,
+    inject_track_hub_source_slide as _inject_track_hub_source_slide,
+    inject_nowtab_control_style_slide as _inject_nowtab_control_style_slide,
+    inject_vinify_logo_position_radios as _inject_vinify_logo_position_radios,
+    inject_vinify_cover_shape_slide as _inject_vinify_cover_shape_slide,
+    inject_nowfy_pulse_style_slide as _inject_nowfy_pulse_style_slide,
+    inject_custom_cover_selector as _inject_custom_cover_selector,
+    on_custom_cover_select as _on_custom_cover_select,
+    on_custom_cover_toggle as _on_custom_cover_toggle,
+)
+from .trackhub_ui import (
+    render_track_hub_box_cell as _render_track_hub_box_cell,
+    clear_track_hub_box_cell as _clear_track_hub_box_cell,
+)
+from .tab_actions import (
+    send_tab_track_download as _send_tab_track_download,
+    send_tab_music_preview as _send_tab_music_preview,
+)
+from .welcome import maybe_show_nowfy_welcome_sheet as _maybe_show_nowfy_welcome_sheet
+
+
+class NowfyCoreBackendMixin:
+    """Compatibility mixin kept for migration safety."""
+
+    pass
+
+
+class NowfyCoreAPI:
+    """Core facade consumed by nowfy.plugin."""
+
+    def __init__(self):
+        self._state = CoreState()
+        self._runtime_plugin = None
+
+    def register_runtime_plugin(self, plugin):
+        self._runtime_plugin = plugin
+        return True
+
+    def is_core_active(self):
+        return True
+
+    def is_addon_enabled(self, plugin, addon_key, default_value=False):
+        return _is_addon_enabled(plugin, addon_key, default_value)
+
+    def are_translation_resources_ready(self):
+        plugin = self._runtime_plugin
+        if plugin is None:
+            return True
+        try:
+            tr_fn = getattr(plugin, "tr", None)
+            if not callable(tr_fn):
+                return True
+            probes = ("custom_command", "nowfy_panel_section_desc", "core_language_label")
+            hits = 0
+            for key in probes:
+                try:
+                    val = str(tr_fn(key) or "").strip()
+                    if val and val != key:
+                        hits += 1
+                except Exception:
+                    pass
+            return hits >= 2
+        except Exception:
+            return True
+
+    def ensure_translation_resources(self, silent=False):
+        plugin = self._runtime_plugin
+        if plugin is None:
+            return True
+        try:
+            if self.are_translation_resources_ready():
+                return True
+            # Best-effort hook if host exposes manual sync action.
+            sync_fn = getattr(plugin, "_run_sync_translations_action", None)
+            if callable(sync_fn):
+                try:
+                    sync_fn()
+                except Exception:
+                    pass
+            return self.are_translation_resources_ready()
+        except Exception:
+            return False
+
+    def maybe_show_nowfy_welcome_sheet(self, plugin):
+        return _maybe_show_nowfy_welcome_sheet(plugin)
+
+    def get_nowtab_control_style(self, plugin):
+        return _get_nowtab_control_style(plugin)
+
+    def apply_nowtab_control_modern_ui(self, plugin, context, controls_row, control_container, *args, **kwargs):
+        return _apply_nowtab_control_modern_ui(plugin, context, controls_row, control_container, *args, **kwargs)
+
+    def update_nowtab_control_modern_state(self, plugin, is_playing):
+        return _update_nowtab_control_modern_state(plugin, is_playing)
+
+    def send_tab_track_download(self, plugin):
+        return _send_tab_track_download(plugin)
+
+    def send_tab_music_preview(self, plugin):
+        return _send_tab_music_preview(plugin)
+
+    def get_track_hub_style(self, plugin):
+        try:
+            return int(plugin.get_setting("track_hub_style", 0) or 0)
+        except Exception:
+            return 0
+
+    def render_track_hub_box_cell(self, plugin, cell, title_text, subtitle_text, cover_url=""):
+        return _render_track_hub_box_cell(plugin, cell, title_text, subtitle_text, cover_url)
+
+    def clear_track_hub_box_cell(self, plugin, cell):
+        return _clear_track_hub_box_cell(plugin, cell)
+
+    def inject_track_hub_source_slide(self, plugin, activity, items):
+        return _inject_track_hub_source_slide(plugin, activity, items)
+
+    def inject_nowtab_control_style_slide(self, plugin, activity, items):
+        return _inject_nowtab_control_style_slide(plugin, activity, items)
+
+    def inject_vinify_logo_position_radios(self, plugin, activity, items):
+        return _inject_vinify_logo_position_radios(plugin, activity, items)
+
+    def inject_vinify_cover_shape_slide(self, plugin, activity, items):
+        return _inject_vinify_cover_shape_slide(plugin, activity, items)
+
+    def inject_nowfy_pulse_style_slide(self, plugin, activity, items):
+        return _inject_nowfy_pulse_style_slide(plugin, activity, items)
+
+    def inject_custom_cover_selector(self, plugin, activity, items):
+        return _inject_custom_cover_selector(plugin, activity, items)
+
+    def on_custom_cover_select(self, plugin, value):
+        return _on_custom_cover_select(plugin, value)
+
+    def on_custom_cover_toggle(self, plugin, enabled_value):
+        return _on_custom_cover_toggle(plugin, enabled_value)
+
+    def get_core_setting(self, key, default=None):
+        return self._state.get(str(key), default, plugin=self._runtime_plugin)
+
+    def set_core_setting(self, key, value):
+        return self._state.set(str(key), value, plugin=self._runtime_plugin)
+
+    def is_theme_enabled(self, plugin, theme_key, default_value=False):
+        raw = str(self.get_core_setting("core_enabled_optional_themes", "") or "").strip()
+        return _is_theme_enabled(plugin, theme_key, default_value, core_enabled_optional_themes=raw)
+
+    def inject_core_theme_multiselect(self, plugin, activity, items):
+        return _inject_core_theme_multiselect(plugin, activity, items)
+
+    def inject_statsfm_profile_custom(self, plugin, activity, items):
+        return _inject_statsfm_profile_custom(plugin, activity, items)
+
+    def inject_services_cards_custom(self, plugin, activity, items):
+        return _inject_services_cards_custom(plugin, activity, items)
+
+    def inject_home_services_entry_custom(self, plugin, activity, items):
+        return _inject_home_services_entry_custom(plugin, activity, items)
+
+    def get_plugin_lang_index(self, plugin):
+        return _get_plugin_lang_index(plugin, key="plugin_lang", default=0)
+
+    def normalize_plugin_lang_index(self, idx):
+        return _normalize_plugin_lang_index(idx)
+
+    def get_plugin_lang_code(self, idx):
+        return _get_plugin_lang_code(idx)
+
+    def on_panel_drawer_toggle(self, plugin, enabled):
+        return _on_panel_drawer_toggle(plugin, enabled)
+
+    def on_panel_disable_logs_toggle(self, plugin, enabled, *args, **kwargs):
+        a0 = args[0] if len(args) >= 1 else None
+        a1 = args[1] if len(args) >= 2 else None
+        a2 = args[2] if len(args) >= 3 else None
+        a3 = args[3] if len(args) >= 4 else None
+        return _on_panel_disable_logs_toggle(plugin, enabled, a0, a1, a2, a3)
+
+    def on_lab_nowplaying_pill_toggle(self, plugin, enabled):
+        return _on_lab_nowplaying_pill_toggle(plugin, enabled)
+
+    def on_lab_send_haptic_toggle(self, plugin, enabled):
+        return _on_lab_send_haptic_toggle(plugin, enabled)
+
+    def clear_cache_data(self, plugin):
+        return _clear_cache_data(plugin)
+
+    def get_bio_feature_services(self, plugin):
+        return _get_bio_feature_services(plugin)
+
+    def build_track_hub_subfragment_items(self, plugin):
+        return _build_track_hub_subfragment_items(plugin)
+
+    def invoke_core_action(self, action_name):
+        plugin = self._runtime_plugin
+        if plugin is None:
+            return False
+        return _invoke_action(plugin, action_name)
+
+    def animate_opening_avatar(self, plugin, avatar_view, from_y_dp=20, duration_ms=620):
+        return _animate_opening_avatar(plugin, avatar_view, from_y_dp, duration_ms)
+
+    def inject_about_support_rich_header(self, plugin, activity, items):
+        return _inject_about_support_rich_header(plugin, activity, items)
+
+    def export_core_settings(self):
+        data = self._state.export()
+        plugin = self._runtime_plugin
+        if plugin is not None:
+            try:
+                data.update(_export_core_settings_from_plugin(plugin))
+            except Exception:
+                pass
+        return data
+
+    def import_core_settings(self, data):
+        applied = self._state.import_settings(data, plugin=self._runtime_plugin)
+        plugin = self._runtime_plugin
+        if plugin is not None:
+            try:
+                _import_core_settings_to_plugin(plugin, data)
+            except Exception:
+                pass
+        return applied
+
+
+_API_SINGLETON = None
+
+
+def get_nowfy_core_api():
+    global _API_SINGLETON
+    if _API_SINGLETON is None:
+        _API_SINGLETON = NowfyCoreAPI()
+    return _API_SINGLETON

nowfycore-1.0.0/src/nowfycore/bridge.py

@@ -0,0 +1,13 @@
+def invoke_action(plugin, action_name):
+    """Invoke a runtime method on host plugin during staged migration."""
+    try:
+        name = str(action_name or "").strip()
+        if not name:
+            return False
+        fn = getattr(plugin, name, None)
+        if not callable(fn):
+            return False
+        fn()
+        return True
+    except Exception:
+        return False

nowfycore-1.0.0/src/nowfycore/cache.py

@@ -0,0 +1,21 @@
+def clear_cache_data(plugin):
+    try:
+        for name in (
+            "_image_cache",
+            "_cache_timestamps",
+            "_enhanced_image_cache",
+            "_base_theme_cache",
+            "_apple_cache",
+            "_youtube_thumbnail_cache",
+            "_soundcloud_thumbnail_cache",
+            "_valid_thumbnail_url_cache",
+        ):
+            try:
+                obj = getattr(plugin, name, None)
+                if isinstance(obj, dict):
+                    obj.clear()
+            except Exception:
+                pass
+        return True
+    except Exception:
+        return False