visualli-bindings 0.1.1__tar.gz

visualli_bindings-0.1.1/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: visualli-bindings
+Version: 0.1.1
+Summary: Official Visualli Pydantic Models
+Requires-Python: >=3.11.0
+Requires-Dist: pydantic>=2.0.0
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

visualli_bindings-0.1.1/README.md

@@ -0,0 +1,49 @@
+# Visualli Python Bindings
+
+Official [Pydantic](https://docs.pydantic.dev/) models for the Visualli specification. These bindings provide a strict, type-safe implementation of the [JSON Schema](../../visualli.schema.json).
+
+## Installation
+
+### From PyPI (Recommended)
+
+```bash
+pip install visualli-bindings
+```
+
+### From Source
+
+```bash
+pip install .
+```
+
+## Usage
+
+These models are purely for data validation and structure definition. They do not include file parsing logic.
+
+```python
+from visualli import Layer, Node
+
+# Create valid objects
+layer = Layer(
+    id="layer-123",
+    level=0,
+    nodes=[
+        Node(
+            id="node-1",
+            position={"x": 0, "y": 0},
+            data={"label": "Central Idea"}
+        )
+    ]
+)
+
+print(layer.model_dump_json(indent=2))
+
+# Validate raw data
+raw_data = {
+    "type": "meta",
+    "version": "0.1",
+    "title": "My Map"
+}
+from visualli import Meta
+meta = Meta(**raw_data) # Raises ValidationError if invalid
+```

visualli_bindings-0.1.1/setup.cfg

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

visualli_bindings-0.1.1/setup.py

@@ -0,0 +1,12 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="visualli-bindings",
+    version="0.1.1",
+    description="Official Visualli Pydantic Models",
+    py_modules=["visualli"],
+    install_requires=[
+        "pydantic>=2.0.0",
+    ],
+    python_requires=">=3.11.0",
+)

visualli_bindings-0.1.1/visualli.py

@@ -0,0 +1,161 @@
+
+from __future__ import annotations
+
+from enum import Enum
+from typing import Annotated, Any, Literal
+
+from pydantic import AwareDatetime, BaseModel, ConfigDict, Field, RootModel
+
+
+class Meta(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    type: Literal["meta"]
+    version: Annotated[str, Field(description="Visualli spec version (e.g. '0.1')")]
+    title: str
+    created: AwareDatetime | None = None
+    lastModified: AwareDatetime | None = None
+
+
+class Extension(BaseModel):
+    type: Literal["extension"]
+    id: Annotated[
+        str,
+        Field(
+            description="Unique identifier for the extension (e.g., 'semantic-anchors')"
+        ),
+    ]
+    data: Annotated[
+        list[Any] | None, Field(description="Data payload for the extension")
+    ] = None
+
+
+class Layout(Enum):
+    """
+    Spatial arrangement of the layer's nodes on the canvas. 'radial' arranges nodes in a circle around the parent node, 'linear-horizontal' arranges them along a horizontal axis, 'linear-vertical' arranges them along a vertical axis.
+    """
+
+    radial = "radial"
+    linear_horizontal = "linear-horizontal"
+    linear_vertical = "linear-vertical"
+
+
+class Position(BaseModel):
+    x: float
+    y: float
+
+
+class Data(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    label: Annotated[str, Field(description="Label text for the node")]
+    summary: Annotated[
+        str, Field(description="A short description or summary of the node content")
+    ]
+    color: str | None = None
+
+
+class Node(BaseModel):
+    id: str
+    position: Position
+    data: Data
+
+
+class Style(Enum):
+    dashed = "dashed"
+    solid = "solid"
+
+
+class Data1(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    label: str
+    style: Style | None = "solid"
+
+
+class Connection(BaseModel):
+    id: str
+    from_: Annotated[str, Field(alias="from", description="Source Node ID")]
+    to: Annotated[str, Field(description="Target Node ID")]
+    data: Data1
+
+
+class Formation(Enum):
+    """
+    Visual arrangement of nodes within the container. Uses the same vocabulary as Layer.layout: 'radial' arranges nodes in a circle, 'linear-horizontal' along a horizontal axis, 'linear-vertical' along a vertical axis.
+    """
+
+    radial = "radial"
+    linear_horizontal = "linear-horizontal"
+    linear_vertical = "linear-vertical"
+
+
+class Style1(Enum):
+    """
+    Visual style of the container border
+    """
+
+    dashed = "dashed"
+    none = "none"
+
+
+class Data2(BaseModel):
+    model_config = ConfigDict(
+        extra="forbid",
+    )
+    label: Annotated[str, Field(description="Container Label")]
+    formation: Annotated[
+        Formation | None,
+        Field(
+            description="Visual arrangement of nodes within the container. Uses the same vocabulary as Layer.layout: 'radial' arranges nodes in a circle, 'linear-horizontal' along a horizontal axis, 'linear-vertical' along a vertical axis."
+        ),
+    ] = None
+    style: Annotated[
+        Style1 | None, Field(description="Visual style of the container border")
+    ] = None
+
+
+class Container(BaseModel):
+    id: str
+    nodes: Annotated[
+        list[str], Field(description="List of Node IDs contained in this group")
+    ]
+    data: Data2
+
+
+class Layer(BaseModel):
+    type: Literal["layer"]
+    id: Annotated[str, Field(description="UUID of the layer")]
+    level: Annotated[int, Field(description="Hierarchy level (0 is root)", ge=0)]
+    parentLayerId: Annotated[
+        str | None, Field(description="UUID of the parent layer")
+    ] = None
+    parentNodeId: Annotated[
+        str | None,
+        Field(
+            description="UUID of the specific node in the parent layer this layer attaches to"
+        ),
+    ] = None
+    layout: Annotated[
+        Layout | None,
+        Field(
+            description="Spatial arrangement of the layer's nodes on the canvas. 'radial' arranges nodes in a circle around the parent node, 'linear-horizontal' arranges them along a horizontal axis, 'linear-vertical' arranges them along a vertical axis."
+        ),
+    ] = None
+    nodes: Annotated[list[Node] | None, Field(validate_default=True)] = []
+    connections: list[Connection] | None = None
+    containers: Annotated[list[Container] | None, Field(validate_default=True)] = []
+
+
+class VisualliSpec011(RootModel[Meta | Extension | Layer]):
+    root: Annotated[
+        Meta | Extension | Layer,
+        Field(
+            description="Schema for a single line in a .visualli (JSONL) file. Each line must be one of: Meta, Extension, or Layer.",
+            discriminator="type",
+            title="Visualli Spec 0.1.1",
+        ),
+    ]

visualli_bindings-0.1.1/visualli_bindings.egg-info/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: visualli-bindings
+Version: 0.1.1
+Summary: Official Visualli Pydantic Models
+Requires-Python: >=3.11.0
+Requires-Dist: pydantic>=2.0.0
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

visualli_bindings-0.1.1/visualli_bindings.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+setup.py
+visualli.py
+visualli_bindings.egg-info/PKG-INFO
+visualli_bindings.egg-info/SOURCES.txt
+visualli_bindings.egg-info/dependency_links.txt
+visualli_bindings.egg-info/requires.txt
+visualli_bindings.egg-info/top_level.txt

visualli_bindings-0.1.1/visualli_bindings.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

visualli_bindings-0.1.1/visualli_bindings.egg-info/requires.txt

@@ -0,0 +1 @@
+pydantic>=2.0.0

visualli_bindings-0.1.1/visualli_bindings.egg-info/top_level.txt

@@ -0,0 +1 @@
+visualli