meltygui 0.1.0__py3-none-any.whl

meltygui/png_unfilter.c

@@ -0,0 +1,49 @@
+/* Undo PNG scanline filters (RFC 2083 §6). Compiled on first use by image_load.py.
+   raw:  h rows of (1 + stride) bytes, filter type byte first.
+   out:  h rows of stride bytes.  bpp = bytes per complete pixel. */
+#include <stdint.h>
+#include <stdlib.h>
+
+static inline int paeth(int a, int b, int c) {
+    int p = a + b - c, pa = abs(p - a), pb = abs(p - b), pc = abs(p - c);
+    return (pa <= pb && pa <= pc) ? a : (pb <= pc ? b : c);
+}
+
+int png_unfilter(const uint8_t *raw, uint8_t *out, int h, int stride, int bpp) {
+    const uint8_t *prior = NULL;
+    for (int y = 0; y < h; y++) {
+        const uint8_t *in = raw + (size_t)y * (stride + 1);
+        uint8_t *cur = out + (size_t)y * stride;
+        int kind = in[0];
+        in++;
+        switch (kind) {
+        case 0:
+            for (int i = 0; i < stride; i++) cur[i] = in[i];
+            break;
+        case 1:
+            for (int i = 0; i < stride; i++) cur[i] = in[i] + (i >= bpp ? cur[i - bpp] : 0);
+            break;
+        case 2:
+            for (int i = 0; i < stride; i++) cur[i] = in[i] + (prior ? prior[i] : 0);
+            break;
+        case 3:
+            for (int i = 0; i < stride; i++) {
+                int a = i >= bpp ? cur[i - bpp] : 0, b = prior ? prior[i] : 0;
+                cur[i] = in[i] + ((a + b) >> 1);
+            }
+            break;
+        case 4:
+            for (int i = 0; i < stride; i++) {
+                int a = i >= bpp ? cur[i - bpp] : 0;
+                int b = prior ? prior[i] : 0;
+                int c = (prior && i >= bpp) ? prior[i - bpp] : 0;
+                cur[i] = in[i] + paeth(a, b, c);
+            }
+            break;
+        default:
+            return -1;
+        }
+        prior = cur;
+    }
+    return 0;
+}

meltygui/resources/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,21 @@
+# Bundled resources
+
+- JetBrains Mono: JetBrains s.r.o., SIL Open Font License 1.1.
+  License: `jetbrains-weights/OFL.txt`. Source: https://github.com/JetBrains/JetBrainsMono
+- DejaVu Sans: Bitstream copyright and DejaVu public-domain changes.
+  License: `dejavu/LICENSE.txt`. Source: https://dejavu-fonts.github.io/
+- Font Awesome 5.15.4 font (stored under the historical filename
+  `fontawesome-webfont.ttf`): Fonticons, Inc., SIL Open Font License 1.1.
+  License: `fontawesome-LICENSE.txt`.
+  Source: https://github.com/FortAwesome/Font-Awesome/tree/5.15.4
+- Studio Small 09 HDR environment: Poly Haven, CC0.
+  Source: https://polyhaven.com/a/studio_small_09
+  License: https://polyhaven.com/license
+
+The adapted pyimgui window integration retains its license in
+`meltygui/windows/backends/PYIMGUI_LICENSE`.
+
+Native support distributions carry their own licenses. In particular, the
+GL-enabled PyCUDA wheel includes NVIDIA's cuRAND runtime and its CUDA 12.1 EULA;
+that runtime is not covered by MeltyGUI's project license. The NVIDIA driver
+and CUDA compiler/toolkit are not bundled in MeltyGUI wheels.

meltygui/resources/dejavu/LICENSE.txt

@@ -0,0 +1,78 @@
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: DejaVu fonts
+Upstream-Author: Stepan Roh <src@users.sourceforge.net> (original author),
+                  see /usr/share/doc/fonts-dejavu-core/AUTHORS for full list
+Source: https://dejavu-fonts.github.io/
+
+Files: *
+Copyright: Copyright (c) 2003 by Bitstream, Inc. All Rights Reserved. 
+ Bitstream Vera is a trademark of Bitstream, Inc.
+ DejaVu changes are in public domain.
+License: bitstream-vera
+ Permission is hereby granted, free of charge, to any person obtaining a copy
+ of the fonts accompanying this license ("Fonts") and associated
+ documentation files (the "Font Software"), to reproduce and distribute the
+ Font Software, including without limitation the rights to use, copy, merge,
+ publish, distribute, and/or sell copies of the Font Software, and to permit
+ persons to whom the Font Software is furnished to do so, subject to the
+ following conditions:
+ .
+ The above copyright and trademark notices and this permission notice shall
+ be included in all copies of one or more of the Font Software typefaces.
+ .
+ The Font Software may be modified, altered, or added to, and in particular
+ the designs of glyphs or characters in the Fonts may be modified and
+ additional glyphs or characters may be added to the Fonts, only if the fonts
+ are renamed to names not containing either the words "Bitstream" or the word
+ "Vera".
+ .
+ This License becomes null and void to the extent applicable to Fonts or Font
+ Software that has been modified and is distributed under the "Bitstream
+ Vera" names.
+ .
+ The Font Software may be sold as part of a larger software package but no
+ copy of one or more of the Font Software typefaces may be sold by itself.
+ .
+ THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+ OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY,
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF COPYRIGHT, PATENT,
+ TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL BITSTREAM OR THE GNOME
+ FOUNDATION BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, INCLUDING
+ ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES,
+ WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
+ THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER DEALINGS IN THE
+ FONT SOFTWARE.
+ .
+ Except as contained in this notice, the names of Gnome, the Gnome
+ Foundation, and Bitstream Inc., shall not be used in advertising or
+ otherwise to promote the sale, use or other dealings in this Font Software
+ without prior written authorization from the Gnome Foundation or Bitstream
+ Inc., respectively. For further information, contact: fonts at gnome dot
+ org.
+
+Files: debian/*
+Copyright: (C) 2005-2006 Peter Cernak <pce@users.sourceforge.net> 
+           (C) 2006-2011 Davide Viti <zinosat@tiscali.it>
+           (C) 2011-2013 Christian Perrier <bubulle@debian.org>
+           (C) 2013 Fabian Greffrath <fabian+debian@greffrath.com>
+License: GPL-2+
+ This program is free software; you can redistribute it
+ and/or modify it under the terms of the GNU General Public
+ License as published by the Free Software Foundation; either
+ version 2 of the License, or (at your option) any later
+ version.
+ .
+ This program is distributed in the hope that it will be
+ useful, but WITHOUT ANY WARRANTY; without even the implied
+ warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
+ PURPOSE.  See the GNU General Public License for more
+ details.
+ .
+ You should have received a copy of the GNU General Public
+ License along with this package; if not, write to the Free
+ Software Foundation, Inc., 51 Franklin St, Fifth Floor,
+ Boston, MA  02110-1301 USA
+ .
+ On Debian systems, the full text of the GNU General Public
+ License version 2 can be found in the file
+ /usr/share/common-licenses/GPL-2'.

meltygui/resources/fontawesome-LICENSE.txt

@@ -0,0 +1,121 @@
+Font Awesome Free License
+-------------------------
+
+Font Awesome Free is free, open source, and GPL friendly. You can use it for
+commercial projects, open source projects, or really almost whatever you want.
+Full Font Awesome Free license: https://fontawesome.com/license/free.
+
+# Icons: CC BY 4.0 License (https://creativecommons.org/licenses/by/4.0/)
+In the Font Awesome Free download, the CC BY 4.0 license applies to all icons
+packaged as SVG and JS file types.
+
+# Fonts: SIL OFL 1.1 License (https://scripts.sil.org/OFL)
+In the Font Awesome Free download, the SIL OFL license applies to all icons
+packaged as web and desktop font files.
+
+# Code: MIT License (https://opensource.org/licenses/MIT)
+In the Font Awesome Free download, the MIT license applies to all non-font and
+non-icon files.
+
+# Attribution
+Attribution is required by MIT, SIL OFL, and CC BY licenses. Downloaded Font
+Awesome Free files already contain embedded comments with sufficient
+attribution, so you shouldn't need to do anything additional when using these
+files normally.
+
+We've kept attribution comments terse, so we ask that you do not actively work
+to remove them from files, especially code. They're a great way for folks to
+learn about Font Awesome.
+
+# Brand Icons
+All brand icons are trademarks of their respective owners. The use of these
+trademarks does not indicate endorsement of the trademark holder by Font
+Awesome, nor vice versa. **Please do not use brand logos for any purpose except
+to represent the company, product, or service to which they refer.**
+
+
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

meltygui/resources/jetbrains-weights/OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The JetBrains Mono Project Authors (https://github.com/JetBrains/JetBrainsMono)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

meltygui/resources/jetbrains-weights/README.md

@@ -0,0 +1,2 @@
+JetBrains Mono weight faces from https://github.com/JetBrains/JetBrainsMono/tree/v2.304/fonts/ttf
+Licensed under the included SIL Open Font License. Regular remains the existing bundled face.

meltygui/state/account_state.py

@@ -0,0 +1,22 @@
+"""Injected state for account views."""
+from meltygui.core.conversion.dict_conversion import DictConversion
+
+
+class AccountsPanelState(DictConversion):
+    """Which per-account panels are open — the usage limits (▾), Ollama's
+    model list, the Edit fields — persisted with the window's draw_state
+    (injected as `panel_state: AccountsPanelState = None`, the TabState
+    pattern) so the window reopens the way it was left. The kinds keep
+    toggling the account dicts' runtime keys (`_usage_open`, …); the window
+    restores those from here on a fresh store (boot / restart) and mirrors
+    them back after every frame. `open` maps "<account id><key>" → True.
+    `usage` maps account id → the Claude plan numbers last fetched
+    (`AnthropicKind.usage_cache_entry`: rows, summary, fetched_wall, email)
+    — restored into a fresh account dict by `restore_usage`, so the panel
+    shows last session's bars until the delayed fetch replaces them."""
+    PANEL_KEYS = ("_usage_open", "_models_open", "_edit")
+
+    def __init__(self):
+        super().__init__()
+        self.open = {}
+        self.usage = {}

meltygui/state/animation_state.py

@@ -0,0 +1,97 @@
+import time
+import meltygui.core.windowing.window_api as glfw
+from typing import Callable, Union, Tuple
+from enum import Enum
+
+from meltygui.core.windowing.glfw_utils import request_render
+
+
+class EaseType(Enum):
+    LINEAR = 'linear'
+    EASE_IN = 'ease_in'
+    EASE_OUT = 'ease_out'
+    EASE_IN_OUT = 'ease_in_out'
+
+
+AnimValue = Union[float, Tuple[float, ...]]
+
+
+class Animator:
+    def __init__(self):
+        self.start_value: AnimValue = 0
+        self.end_value: AnimValue = 0
+        self.duration = 0
+        self.start_time = 0
+        self.is_animating = False
+        self.on_update: Callable[[AnimValue], None] = lambda x: None
+        self.ease_type = EaseType.LINEAR
+
+    def _ease(self, t: float) -> float:
+        if self.ease_type == EaseType.LINEAR:
+            return t
+        elif self.ease_type == EaseType.EASE_IN:
+            return t * t
+        elif self.ease_type == EaseType.EASE_OUT:
+            return 1 - (1 - t) * (1 - t)
+        elif self.ease_type == EaseType.EASE_IN_OUT:
+            if t < 0.5:
+                return 2 * t * t
+            return 1 - (-2 * t + 2) ** 2 / 2
+        return t
+
+    def _interpolate(self, start: AnimValue, end: AnimValue, progress: float) -> AnimValue:
+        """Interpolate between start and end values, handling both floats and tuples."""
+        if isinstance(start, tuple) and isinstance(end, tuple):
+            # Interpolate each component of the tuple
+            return tuple(
+                start[i] + (end[i] - start[i]) * progress
+                for i in range(len(start))
+            )
+        else:
+            # Handle as float
+            return start + (end - start) * progress
+
+    def stop(self):
+        """Stop the current animation."""
+        self.is_animating = False
+
+    def animate(self, start: AnimValue, end: AnimValue, duration: float,
+                on_update: Callable[[AnimValue], None], ease_type: EaseType = EaseType.EASE_IN_OUT):
+        """
+        Start animation with support for both float and tuple values.
+
+        Args:
+            start: Starting value (float or tuple of floats)
+            end: Ending value (float or tuple of floats)
+            duration: Animation duration in seconds
+            on_update: Callback function that accepts either float or tuple
+            ease_type: Type of easing function to use
+        """
+        if isinstance(start, tuple) != isinstance(end, tuple):
+            raise ValueError("Start and end values must be the same type (both float or both tuple)")
+        if isinstance(start, tuple) and len(start) != len(end):
+            raise ValueError("Start and end tuples must have the same length")
+
+        self.start_value = start
+        self.end_value = end
+        self.duration = duration
+        self.start_time = time.time()
+        self.is_animating = True
+        self.on_update = on_update
+        self.ease_type = ease_type
+
+    def update(self):
+        if not self.is_animating:
+            return
+
+        elapsed = time.time() - self.start_time
+        if elapsed >= self.duration:
+            self.is_animating = False
+            self.on_update(self.end_value)
+            return
+
+        progress = self._ease(elapsed / self.duration)
+        current = self._interpolate(self.start_value, self.end_value, progress)
+
+        self.on_update(current)
+        request_render()  # Request next frame

meltygui/state/annotation_state.py

@@ -0,0 +1,22 @@
+from enum import Enum
+from typing import Any
+
+from meltygui.core.rendering.core_decoration import Core
+
+
+class AnnotationOverride:
+    """Carrier produced when a ``@render_func`` view function is used as a field
+    annotation, e.g. ``alpha: draw_float(min_value=15.0)`` or ``tint: draw_tuple``.
+
+    It just holds the view function and any per-field kwarg overrides captured at
+    class-definition time. ``FieldMeta`` extracts these and registers them into
+    Melty's ``default_funcs_by_name_type`` / ``default_kwargs_by_attrib_type``
+    maps, keyed by (owning class, attribute) — the same place ``@defaults``
+    writes. Nothing reads the carrier after that."""
+
+    is_annotation_override = True
+
+    def __init__(self, view_function=None, kwargs=None):
+        self.view_function = view_function
+        self.kwargs = dict(kwargs or {})
+

meltygui/state/chat_state.py

@@ -0,0 +1,36 @@
+"""Injected state for chat views."""
+from meltygui.core.rendering.core_decoration import no_save
+from meltygui.core.conversion.dict_conversion import DictConversion
+
+
+@no_save("revision", "viewports", "text_layouts", "rename")
+class ChatInterfaceState(DictConversion):
+    def __init__(self):
+        super().__init__()
+        self.provider = ""
+        self.account = ""
+        self.selected = {}
+        self.drafts = {}
+        self.draft_generations = {}
+        self.projects = {}
+        self.follow = True
+        self.answers = {}
+        self.revision = 0
+        self.viewports = {}
+        self.text_layouts = {}
+        self.rename = None
+        self.chat_menu = None
+        self.message_expanded = {}
+        self.concise = False
+        self.action_groups = {}
+        self.output_expanded = {}
+        self.image_sizes = {}
+        # The sidebar's age filter: conversations active within this many
+        # hours (0 = all). AGE_FILTERS lists the choices.
+        self.age_hours = 0
+        # The sources (account ids) whose conversations the sidebar shows -
+        # the tabs lit in the source bar: empty = just `account`.
+        self.sources = []
+        self.folder_expanded = {}
+        self.folders_default_expanded = True
+        self.sections_expanded = {"recent": True, "all": True, "accounts": True}

meltygui/state/code_state.py

@@ -0,0 +1,10 @@
+"""Injected state for code views."""
+from meltygui.core.conversion.dict_conversion import DictConversion
+
+
+class SourcePreviewState(DictConversion):
+    def __init__(self):
+        super().__init__()
+        self.path = None
+        self.line = None
+        self.token = None

meltygui/state/core_enums.py

@@ -0,0 +1,59 @@
+import itertools
+import random
+import uuid
+
+from meltygui.state.model_enums import RelaxedEnum
+from meltygui.core.rendering.core_decoration import defaults
+
+# Monotonic id source: a per-process RANDOM start + a counter. next() on an
+# itertools.count is atomic under the GIL (thread-safe). The random start keeps
+# ids from separate runs apart (a bare counter would restart at 0 each run and
+# collide with loaded ids); the counter makes ids collision-free WITHIN a run
+# (the old uuid4[0:6] = 24 random bits actually collides for long graphs).
+_id_counter = itertools.count(random.getrandbits(24))
+
+
+class OffscreenDebugMode(RelaxedEnum):
+    OFF = "Off"
+    SHOW_LAYERS = "Show Layers"
+    SHOW_MASK = "Show Mask"
+
+
+class OffscreenDebugMode(RelaxedEnum):
+    OFF = "Off"
+    SHOW_LAYERS = "layer"
+    SHOW_MASK = "mask"
+    SHOW_UV = "uv"
+    SHOW_SRC_PX = "srcpx"
+    SHOW_CHECKER = "checker"
+    SHOW_SOLID = "solid"
+
+
+class ViewMode(RelaxedEnum):
+    NONE = "None"
+    IMGUI_WINDOW = "imgui-window"
+
+
+class ProfileMode(RelaxedEnum):
+    OFF = "Off"
+    LIGHT = "Light"
+    ON = "On"
+    
+
+
+class PendingAction(RelaxedEnum):
+    APPLY = "apply"
+    REVERT = "revert"
+    LOAD = "load"
+
+
+def generate_id():
+    """
+    Generates a unique identifier for use in ImGui elements.
+    This is useful to ensure that elements can be uniquely identified across frames.
+    :return: A unique identifier string (6+ hex chars; survives the [0:8] id trunc).
+
+    ~11x faster than the old uuid4[0:6] (no /dev/urandom read per call), and
+    collision-free within a process.
+    """
+    return format(next(_id_counter), "06x")