pinky-streamlit 0.1.0.dev1__py3-none-any.whl

pinky_streamlit/__init__.py

@@ -0,0 +1,70 @@
+"""
+pinky-streamlit
+========================
+Reusable Streamlit in Snowflake components for the pinky suite.
+
+Modules are implemented incrementally. Import with sks_ aliases to avoid
+shadowing Streamlit's own st.* names:
+
+    from pinky_streamlit import PALETTES, PALETTE, setup_page, Logo
+    from pinky_streamlit import text as sks_text, header as sks_header
+    from pinky_streamlit import metric as sks_metric, detail as sks_detail
+    from pinky_streamlit import bar_chart as sks_bar_chart
+    from pinky_streamlit import filters as sks_filters, action_grid as sks_action_grid
+    from pinky_streamlit import card_grid as sks_card_grid, divider as sks_divider
+    from pinky_streamlit import status_card as sks_status_card
+"""
+
+from pinky_streamlit.core import (
+    ICONS,
+    MATERIAL_ICONS,
+    PALETTE,
+    PALETTES,
+    AppFont,
+    DEFAULT_FONT,
+    Icon,
+    LocalSessionConfig,
+    SessionInfo,
+    Logo,
+    Palette,
+    PaletteColors,
+    add_status_icons,
+    get_session,
+    insert_data,
+    invalidate_crud,
+    load_analytic,
+    load_crud,
+    load_nocache,
+    load_static,
+    setup_page,
+    update_data,
+)
+
+__all__ = [
+    # design system
+    "Icon",
+    "ICONS",
+    "PaletteColors",
+    "Palette",
+    "PALETTES",
+    "PALETTE",
+    "MATERIAL_ICONS",
+    # session
+    "LocalSessionConfig",
+    "SessionInfo",
+    "get_session",
+    # db
+    "update_data",
+    "insert_data",
+    "add_status_icons",
+    "load_static",
+    "load_analytic",
+    "load_crud",
+    "invalidate_crud",
+    "load_nocache",
+    # page
+    "AppFont",
+    "DEFAULT_FONT",
+    "Logo",
+    "setup_page",
+]

pinky_streamlit/core/__init__.py

@@ -0,0 +1,52 @@
+"""pinky_streamlit.core — foundational layer (session, DB, design system)."""
+
+from .constants import (
+    ICONS,
+    MATERIAL_ICONS,
+    PALETTE,
+    PALETTES,
+    Icon,
+    Palette,
+    PaletteColors,
+)
+from .db import (
+    add_status_icons,
+    insert_data,
+    invalidate_crud,
+    load_analytic,
+    load_crud,
+    load_nocache,
+    load_static,
+    update_data,
+)
+from .page import DEFAULT_FONT, AppFont, Logo, setup_page
+from .session import LocalSessionConfig, SessionInfo, get_session
+
+__all__ = [  # noqa: RUF022 — grouped by layer, not alpha
+    # design system
+    "Icon",
+    "ICONS",
+    "PaletteColors",
+    "Palette",
+    "PALETTES",
+    "PALETTE",
+    "MATERIAL_ICONS",
+    # session
+    "LocalSessionConfig",
+    "SessionInfo",
+    "get_session",
+    # db
+    "update_data",
+    "insert_data",
+    "add_status_icons",
+    "load_static",
+    "load_analytic",
+    "load_crud",
+    "invalidate_crud",
+    "load_nocache",
+    # page
+    "AppFont",
+    "DEFAULT_FONT",
+    "Logo",
+    "setup_page",
+]

pinky_streamlit/core/constants.py

@@ -0,0 +1,467 @@
+"""
+pinky_streamlit.constants
+==================================
+Shared constants for the design system: color palette and icon registry.
+
+Usage::
+
+    from pinky_streamlit import ICONS, PALETTE
+
+    st.badge("",  icon=ICONS.SUCCESS.material)   # :material/check_circle:
+    st.badge("✅", icon=ICONS.SUCCESS.emoji)      # ✅
+    st.badge("",  icon=str(ICONS.SUCCESS))        # same as .material (default)
+"""
+
+from __future__ import annotations
+
+import colorsys
+from dataclasses import dataclass
+
+# ── Icon ──────────────────────────────────────────────────────────────────────
+
+
+@dataclass(frozen=True)
+class Icon:
+    """A design-system icon with both a Material Symbol and an emoji variant.
+
+    ``str(icon)`` returns the material string — safe to pass to any Streamlit
+    argument that accepts a Material Symbol (icon=, st.badge, st.button…).
+    Use ``.emoji`` for components that don't support ``:material/…:`` syntax.
+
+    To extend the registry with app-specific icons, subclass ICONS::
+
+        from pinky_streamlit import ICONS, Icon
+
+        class MyIcons(ICONS):
+            CAT    = Icon(":material/pets:",          "🐱")
+            RABBIT = Icon(":material/cruelty_free:",  "🐰")
+    """
+
+    material: str
+    emoji: str
+
+    def __str__(self) -> str:
+        return self.material
+
+
+class ICONS:
+    """Kit icon registry — subclass to add app-specific icons.
+
+    Access via ``ICONS.<NAME>.material`` or ``ICONS.<NAME>.emoji``.
+    """
+
+    # ── Navigation & layout ───────────────────────────────────────────────────
+    HOME = Icon(":material/home:", "🏠")
+    DASHBOARD = Icon(":material/dashboard:", "📋")
+    WIDGETS = Icon(":material/widgets:", "🧩")
+    SETTINGS = Icon(":material/settings:", "⚙️")
+    ADMIN = Icon(":material/admin_panel_settings:", "🛡️")
+    FILTER = Icon(":material/filter_list:", "🔽")
+    SORT = Icon(":material/sort:", "↕️")
+    SEARCH = Icon(":material/search:", "🔍")
+    EXPAND = Icon(":material/expand_more:", "▼")
+    COLLAPSE = Icon(":material/expand_less:", "▲")
+    BACK = Icon(":material/arrow_back:", "◀")
+    FORWARD = Icon(":material/arrow_forward:", "▶")
+    ARROW_RIGHT = Icon(":material/arrow_right:", "→")
+    LINK = Icon(":material/link:", "🔗")
+    PIN = Icon(":material/push_pin:", "📌")
+    TAG = Icon(":material/tag:", "🏷️")
+    COPY = Icon(":material/content_copy:", "📋")
+
+    # ── Status & feedback ─────────────────────────────────────────────────────
+    SUCCESS = Icon(":material/check_circle:", "✅")
+    WARNING = Icon(":material/warning:", "⚠️")
+    ERROR = Icon(":material/error:", "🚨")
+    INFO = Icon(":material/info:", "ℹ️")  # noqa: RUF001
+    HELP = Icon(":material/help:", "❓")
+    LEGEND = Icon(":material/live_help:", "💡")
+    UNDEFINED = Icon(":material/remove:", "—")
+    CELEBRATION = Icon(":material/celebration:", "🎉")
+    BLOCKED = Icon(":material/block:", "🚫")
+    DO_NOT_DISTURB = Icon(":material/do_not_disturb_on:", "⛔")
+    CHECK = Icon(":material/check:", "✓")
+    CANCEL = Icon(":material/cancel:", "❌")
+    FLAG = Icon(":material/flag:", "🚩")
+    STAR = Icon(":material/star:", "⭐")
+    SKULL = Icon(":material/skull:", "💀")
+    NOTIFICATION = Icon(":material/notifications:", "🔔")
+    SATISFIED = Icon(":material/sentiment_satisfied:", "🙂")
+    NEUTRAL = Icon(":material/sentiment_neutral:", "😐")
+    DISSATISFIED = Icon(":material/sentiment_dissatisfied:", "☹️")
+
+    # ── Actions ───────────────────────────────────────────────────────────────
+    ADD = Icon(":material/add:", "+")
+    ADD_ROW = Icon(":material/docs_add_on:", "+")
+    EDIT = Icon(":material/edit:", "✏️")
+    EDIT_COLUMN = Icon(":material/edit_note:", "📝")
+    DELETE = Icon(":material/delete:", "🗑️")
+    SAVE = Icon(":material/save:", "💾")
+    CLOSE = Icon(":material/close:", "✖️")
+    REFRESH = Icon(":material/refresh:", "🔄")
+    SYNC = Icon(":material/sync:", "🔄")
+    PLAY = Icon(":material/play_arrow:", "▶️")
+    PAUSE = Icon(":material/pause:", "⏸️")
+    STOP = Icon(":material/stop:", "⏹️")
+    EXECUTE = Icon(":material/electric_bolt:", "⚡")
+    MANUAL = Icon(":material/touch_app:", "👆")
+    TRIGGERED = Icon(":material/calendar_clock:", "⏰")
+    SP_PARAMS = Icon(":material/settings_timelapse:", "⏱️")
+    LOCK = Icon(":material/lock:", "🔒")
+    UNLOCK = Icon(":material/lock_open:", "🔓")
+    VISIBLE = Icon(":material/visibility:", "👁️")
+    HIDDEN = Icon(":material/visibility_off:", "🙈")
+
+    # ── Files & data ──────────────────────────────────────────────────────────
+    DOWNLOAD = Icon(":material/cloud_download:", "📥")
+    UPLOAD = Icon(":material/upload_file:", "📤")
+    CLOUD_UPLOAD = Icon(":material/cloud_upload:", "☁️")
+    FILE = Icon(":material/description:", "📄")
+    FOLDER = Icon(":material/folder:", "📁")
+    TABLE = Icon(":material/table:", "📋")
+    TABLE_EDIT = Icon(":material/table_edit:", "📝")
+    TABLE_READONLY = Icon(":material/edit_off:", "🔒")
+    OUTPUT = Icon(":material/output:", "📤")
+
+    # ── Content ───────────────────────────────────────────────────────────────
+    ARTICLE = Icon(":material/article:", "📄")
+    IMAGE = Icon(":material/image:", "🖼️")
+    CHAT = Icon(":material/chat:", "💬")
+    CARDS = Icon(":material/cards:", "🃏")
+    MAIL = Icon(":material/mail:", "📧")
+
+    # ── Users & org ───────────────────────────────────────────────────────────
+    USER = Icon(":material/person:", "👤")
+    USERS = Icon(":material/group:", "👥")
+    BUILDING = Icon(":material/apartment:", "🏢")
+    COMPANY = Icon(":material/business:", "🏢")
+
+    # ── Analytics & time ──────────────────────────────────────────────────────
+    ANALYTICS = Icon(":material/analytics:", "📊")
+    CHART = Icon(":material/bar_chart:", "📊")
+    CHARTS = Icon(":material/insert_chart:", "📊")
+    TIMELINE = Icon(":material/timeline:", "📈")
+    TRENDING_UP = Icon(":material/trending_up:", "📈")
+    TRENDING_DOWN = Icon(":material/trending_down:", "📉")
+    CALENDAR = Icon(":material/calendar_month:", "📅")
+    CLOCK = Icon(":material/schedule:", "🕐")
+    HISTORY = Icon(":material/history:", "🕰️")
+    UPDATE = Icon(":material/update:", "🔄")
+
+    # ── Finance ───────────────────────────────────────────────────────────────
+    MONEY = Icon(":material/payments:", "💰")
+    RECEIPT = Icon(":material/receipt_long:", "🧾")
+
+
+# ── Palette ───────────────────────────────────────────────────────────────────
+
+
+@dataclass(frozen=True)
+class PaletteColors:
+    """Color set for one mode (light or dark).
+
+    ``primary``, ``secondary``, ``tertiary`` are the brand accent colors.
+    Semantic colors default to the pythia theme values and are usually kept
+    stable across themes.
+    """
+
+    primary: str
+    secondary: str
+    tertiary: str
+    success: str = "#09ab3b"
+    warning: str = "#ffa421"
+    error: str = "#ff4b4b"
+    grey: str = "#535353"
+
+
+@dataclass(frozen=True)
+class Palette:
+    """A complete theme with light and dark color sets.
+
+    Pass to ``setup_page(palette=...)`` to inject brand colors as CSS variables.
+    All ``color-mix()`` shades in style.css are derived automatically from these
+    base colors — no CSS file needs editing.
+
+    Usage::
+
+        from pinky_streamlit import PALETTES, setup_page
+
+        messages, main, df = setup_page(session, loaders=[...], palette=PALETTES.APPLE)
+
+    Extend with a custom palette::
+
+        from pinky_streamlit import Palette, PaletteColors
+
+        # Dark auto-computed from light
+        MY_PALETTE = Palette(
+            light=PaletteColors(primary="#6200ea", secondary="#00bcd4", tertiary="#76ff03"),
+        )
+
+        # Full control over dark variant
+        MY_PALETTE = Palette(
+            light=PaletteColors(primary="#6200ea", secondary="#00bcd4", tertiary="#76ff03"),
+            dark=PaletteColors( primary="#b388ff", secondary="#80deea", tertiary="#ccff90"),
+        )
+    """
+
+    light: PaletteColors
+    dark: PaletteColors | None = None
+
+    def to_config_toml(
+        self,
+        font_files: list[str] | None = None,
+    ) -> str:
+        """Generate ``.streamlit/config.toml`` content from this palette.
+
+        For Streamlit Container Runtime apps: sets ``primaryColor`` natively
+        for both light and dark themes. This fixes the KNOWN LIMITATIONS in
+        ``style.css`` (slider track fill, date picker selected day) that
+        cannot be overridden via CSS — Streamlit now applies the color
+        at the React level.
+
+        ``setup_page()`` still injects ``style.css`` + CSS variables for the
+        full design system (``--primary-darker``, ``color-mix()`` shades,
+        component overrides). This method handles what ``config.toml``
+        can absorb; CSS handles the rest.
+
+        Font injection via base64 (``AppFont``) is no longer needed in
+        Container Runtime — pass font files instead and set ``font=None``
+        in ``setup_page()``.
+
+        Args:
+            font_files: Project-relative paths to font files to bundle
+                        (e.g. ``["static/DMSans.woff2"]``). ``None`` = no
+                        custom font declared in config.toml.
+
+        Returns:
+            String content to write to ``.streamlit/config.toml``.
+
+        Example::
+
+            from pinky_streamlit import PALETTES
+
+            toml = PALETTES.PYTHIA.to_config_toml(
+                font_files=["static/DMSans.woff2"]
+            )
+            # Write to .streamlit/config.toml in your app project.
+        """
+        dc = self.dark if self.dark is not None else _auto_dark_palette(self.light)
+        lines: list[str] = [
+            "[theme.light]",
+            f'primaryColor = "{self.light.primary}"',
+            "",
+            "[theme.dark]",
+            f'primaryColor = "{dc.primary}"',
+        ]
+        if font_files:
+            formatted = "[" + ", ".join(f'"{f}"' for f in font_files) + "]"
+            lines += [
+                "",
+                "[theme]",
+                'font = "custom"',
+                f"fontFiles = {formatted}",
+            ]
+        return "\n".join(lines) + "\n"
+
+
+# ── Dark-mode auto-computation ────────────────────────────────────────────────
+
+
+def _auto_dark_color(hex_color: str) -> str:
+    """Return a dark-mode variant of *hex_color*.
+
+    Pulls lightness toward 0.60 (legible on dark backgrounds without glare)
+    and slightly desaturates. Hue is preserved.
+    """
+    raw = hex_color.lstrip("#")
+    r, g, b = (int(raw[i : i + 2], 16) / 255.0 for i in (0, 2, 4))
+    h, lum, s = colorsys.rgb_to_hls(r, g, b)
+    new_lum = max(0.35, min(0.75, 0.60 + (lum - 0.60) * 0.30))
+    new_s = min(1.0, s * 0.90)
+    r2, g2, b2 = colorsys.hls_to_rgb(h, new_lum, new_s)
+    return f"#{round(r2 * 255):02x}{round(g2 * 255):02x}{round(b2 * 255):02x}"
+
+
+def _auto_dark_palette(light: PaletteColors) -> PaletteColors:
+    """Derive a dark-mode ``PaletteColors`` from a light-mode one."""
+    return PaletteColors(
+        primary=_auto_dark_color(light.primary),
+        secondary=_auto_dark_color(light.secondary),
+        tertiary=_auto_dark_color(light.tertiary),
+        success=_auto_dark_color(light.success),
+        warning=_auto_dark_color(light.warning),
+        error=_auto_dark_color(light.error),
+        grey=_auto_dark_color(light.grey),
+    )
+
+
+# ── Pre-built palettes ────────────────────────────────────────────────────────
+
+
+class PALETTES:
+    """Pre-built color palettes — subclass to add app-specific themes.
+
+    Access via ``PALETTES.PYTHIA``, ``PALETTES.STREAMLIT``, etc.
+    Pass to ``setup_page(palette=PALETTES.PYTHIA)`` to activate.
+    Dark mode is auto-computed unless overridden via ``dark=PaletteColors(...)``.
+
+    To extend with custom palettes, subclass ``PALETTES``::
+
+        from pinky_streamlit import PALETTES, Palette, PaletteColors
+
+        class AppPalettes(PALETTES):
+            MY_BRAND = Palette(
+                light=PaletteColors(primary="#6200ea", secondary="#00bcd4", tertiary="#76ff03"),
+            )
+    """
+
+    # Pinky brand — coral / slate blue / raspberry pink
+    PINKY = Palette(
+        light=PaletteColors(primary="#f1a1a0", secondary="#7b8fa8", tertiary="#ca748f"),
+    )
+
+    # Pythia brand — violet / rose / cyan
+    PYTHIA = Palette(
+        light=PaletteColors(primary="#7056d7", secondary="#e07baa", tertiary="#60defb"),
+    )
+
+    # Anthropic brand — coral / teal / warm sand
+    ANTHROPIC = Palette(
+        light=PaletteColors(primary="#d97756", secondary="#4a8c8c", tertiary="#c9a07a"),
+    )
+
+    # Streamlit brand — red / blue / green (exact brand colors)
+    STREAMLIT = Palette(
+        light=PaletteColors(primary="#ff4b4b", secondary="#0068c9", tertiary="#09ab3b"),
+    )
+
+    # Apple — blue / orange / purple (with brand semantic tokens)
+    APPLE = Palette(
+        light=PaletteColors(
+            primary="#0066cc",
+            secondary="#ff9900",
+            tertiary="#9900cc",
+            success="#00cc44",
+            warning="#ffcc00",
+            error="#d10000",
+        ),
+    )
+
+    # GitHub Primer — blue / green / purple
+    GITHUB = Palette(
+        light=PaletteColors(primary="#0969da", secondary="#2da44e", tertiary="#9a3ecb"),
+    )
+
+    # Python — blue / yellow / navy (logo colors)
+    PYTHON = Palette(
+        light=PaletteColors(primary="#3776ab", secondary="#ffd43b", tertiary="#1e415e"),
+    )
+
+    # Duck DB — black / yellow / white (logo colors)
+    DUCK_DB = Palette(
+        light=PaletteColors(primary="#000000", secondary="#fcf150", tertiary="#ffffff"),
+    )
+
+
+# ── Color palette (backward compat) ───────────────────────────────────────────
+# Used by ui_charts.py (CHART_COLORS). Mirrors PALETTES.PYTHIA.light.
+PALETTE: dict[str, str] = {
+    "primary": PALETTES.PYTHIA.light.primary,
+    "secondary": PALETTES.PYTHIA.light.secondary,
+    "tertiary": PALETTES.PYTHIA.light.tertiary,
+    "success": PALETTES.PYTHIA.light.success,
+    "warning": PALETTES.PYTHIA.light.warning,
+    "error": PALETTES.PYTHIA.light.error,
+    "grey": PALETTES.PYTHIA.light.grey,
+}
+
+# ── Backward compat ───────────────────────────────────────────────────────────
+# MATERIAL_ICONS is deprecated — migrate to ICONS.<NAME>.material
+MATERIAL_ICONS: dict[str, str] = {
+    k: v
+    for k, v in {
+        "home": str(ICONS.HOME),
+        "widgets": str(ICONS.WIDGETS),
+        "data": str(ICONS.ARTICLE),
+        "charts": str(ICONS.CHARTS),
+        "image": str(ICONS.IMAGE),
+        "chat": str(ICONS.CHAT),
+        "cards": str(ICONS.CARDS),
+        "article": str(ICONS.ARTICLE),
+        "dashboard": str(ICONS.DASHBOARD),
+        "settings": str(ICONS.SETTINGS),
+        "admin": str(ICONS.ADMIN),
+        "user": str(ICONS.USER),
+        "users": str(ICONS.USERS),
+        "search": str(ICONS.SEARCH),
+        "filter": str(ICONS.FILTER),
+        "sort": str(ICONS.SORT),
+        "refresh": str(ICONS.REFRESH),
+        "sync": str(ICONS.SYNC),
+        "save": str(ICONS.SAVE),
+        "edit": str(ICONS.EDIT),
+        "edit_column": str(ICONS.EDIT_COLUMN),
+        "delete": str(ICONS.DELETE),
+        "add": str(ICONS.ADD),
+        "add_row": str(ICONS.ADD_ROW),
+        "close": str(ICONS.CLOSE),
+        "check": str(ICONS.CHECK),
+        "cancel": str(ICONS.CANCEL),
+        "info": str(ICONS.INFO),
+        "warning": str(ICONS.WARNING),
+        "error": str(ICONS.ERROR),
+        "success": str(ICONS.SUCCESS),
+        "help": str(ICONS.HELP),
+        "legend": str(ICONS.LEGEND),
+        "undefined": str(ICONS.UNDEFINED),
+        "blocked": str(ICONS.BLOCKED),
+        "do_not_disturb": str(ICONS.DO_NOT_DISTURB),
+        "download": str(ICONS.DOWNLOAD),
+        "upload": str(ICONS.UPLOAD),
+        "cloud_upload": str(ICONS.CLOUD_UPLOAD),
+        "file": str(ICONS.FILE),
+        "folder": str(ICONS.FOLDER),
+        "table": str(ICONS.TABLE),
+        "table_edit": str(ICONS.TABLE_EDIT),
+        "table_readonly": str(ICONS.TABLE_READONLY),
+        "chart": str(ICONS.CHART),
+        "timeline": str(ICONS.TIMELINE),
+        "calendar": str(ICONS.CALENDAR),
+        "clock": str(ICONS.CLOCK),
+        "history": str(ICONS.HISTORY),
+        "update": str(ICONS.UPDATE),
+        "mail": str(ICONS.MAIL),
+        "notification": str(ICONS.NOTIFICATION),
+        "lock": str(ICONS.LOCK),
+        "unlock": str(ICONS.UNLOCK),
+        "visible": str(ICONS.VISIBLE),
+        "hidden": str(ICONS.HIDDEN),
+        "expand": str(ICONS.EXPAND),
+        "collapse": str(ICONS.COLLAPSE),
+        "back": str(ICONS.BACK),
+        "forward": str(ICONS.FORWARD),
+        "arrow_right": str(ICONS.ARROW_RIGHT),
+        "link": str(ICONS.LINK),
+        "copy": str(ICONS.COPY),
+        "tag": str(ICONS.TAG),
+        "play": str(ICONS.PLAY),
+        "pause": str(ICONS.PAUSE),
+        "stop": str(ICONS.STOP),
+        "execute": str(ICONS.EXECUTE),
+        "output": str(ICONS.OUTPUT),
+        "manual": str(ICONS.MANUAL),
+        "triggered": str(ICONS.TRIGGERED),
+        "sp_params": str(ICONS.SP_PARAMS),
+        "building": str(ICONS.BUILDING),
+        "company": str(ICONS.COMPANY),
+        "money": str(ICONS.MONEY),
+        "receipt": str(ICONS.RECEIPT),
+        "analytics": str(ICONS.ANALYTICS),
+        "trending_up": str(ICONS.TRENDING_UP),
+        "trending_down": str(ICONS.TRENDING_DOWN),
+        "flag": str(ICONS.FLAG),
+        "star": str(ICONS.STAR),
+        "pin": str(ICONS.PIN),
+        "skull": str(ICONS.SKULL),
+    }.items()
+}