ai37-a2ui-catalog 0.3.0__tar.gz

ai37_a2ui_catalog-0.3.0/PKG-INFO

@@ -0,0 +1,17 @@
+Metadata-Version: 2.4
+Name: ai37-a2ui-catalog
+Version: 0.3.0
+Summary: Pydantic models and validation helpers for the AI37 A2UI catalog
+Author: AI37
+Author-email: dev@ai37.ru
+Requires-Python: >=3.13,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: pydantic (>=2.11.7,<3.0.0)
+Description-Content-Type: text/markdown
+
+# ai37-a2ui-catalog
+
+Python validation package for the AI37 A2UI catalog.
+

ai37_a2ui_catalog-0.3.0/README.md

@@ -0,0 +1,3 @@
+# ai37-a2ui-catalog
+
+Python validation package for the AI37 A2UI catalog.

ai37_a2ui_catalog-0.3.0/pyproject.toml

@@ -0,0 +1,26 @@
+[project]
+name = "ai37-a2ui-catalog"
+version = "0.3.0"
+description = "Pydantic models and validation helpers for the AI37 A2UI catalog"
+readme = "README.md"
+authors = [{ name = "AI37", email = "dev@ai37.ru" }]
+requires-python = ">=3.13,<4.0"
+dependencies = [
+	"pydantic>=2.11.7,<3.0.0"
+]
+
+[tool.poetry.dependencies]
+
+
+[tool.poetry]
+packages = [{ include = "ai37_a2ui_catalog", from = "src" }]
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.4.2"
+
+[build-system]
+requires = ["poetry-core>=2.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]

ai37_a2ui_catalog-0.3.0/src/ai37_a2ui_catalog/__init__.py

@@ -0,0 +1,16 @@
+from .constants import CATALOG_ID, CATALOG_VERSION
+from .models import ChoiceCardProps, FlexTableProps, FormCardProps, LatexFormulaProps, SimpleTableProps
+from .validation import get_component_schema, validate_component_payload, validate_component_payload_json
+
+__all__ = [
+    "CATALOG_ID",
+    "CATALOG_VERSION",
+    "ChoiceCardProps",
+    "FlexTableProps",
+    "FormCardProps",
+    "LatexFormulaProps",
+    "SimpleTableProps",
+    "get_component_schema",
+    "validate_component_payload",
+    "validate_component_payload_json",
+]

ai37_a2ui_catalog-0.3.0/src/ai37_a2ui_catalog/constants.py

@@ -0,0 +1,12 @@
+from __future__ import annotations
+
+CATALOG_SLUG = "ai37-a2ui"
+CATALOG_VERSION = "v2"
+# Хостинг каталога — GitHub Pages проекта AI-37/ai37-a2ui-catalog (см. constants.ts).
+CATALOG_BASE_URL = (
+    f"https://ai-37.github.io/ai37-a2ui-catalog/a2ui/catalogs/{CATALOG_SLUG}/{CATALOG_VERSION}"
+)
+CATALOG_ID = f"{CATALOG_BASE_URL}/catalog.json"
+# Id базового каталога A2UI (basicCatalog @a2ui) — для content-negotiation вывода
+# (MIME application/vnd.a2ui+json → base). См. constants.ts.
+A2UI_BASE_CATALOG_ID = "https://a2ui.org/specification/v0_9/catalogs/basic/catalog.json"

ai37_a2ui_catalog-0.3.0/src/ai37_a2ui_catalog/models/__init__.py

@@ -0,0 +1,35 @@
+from .choice_card import ChoiceCardProps, ChoiceCardSubmit, ChoiceOption
+from .flex_table import FlexTableCell, FlexTableProps, FlexTableRow
+from .form_card import FormCardProps, FormCardSubmit, FormField, FormFieldType
+from .latex_formula import LatexFormulaProps
+from .shared import CellPrimitive, StrictModel, TextAlign
+from .simple_table import SimpleTableColumn, SimpleTableProps, SimpleTableRow
+
+COMPONENT_MODELS = {
+    "SimpleTable": SimpleTableProps,
+    "FlexTable": FlexTableProps,
+    "LatexFormula": LatexFormulaProps,
+    "ChoiceCard": ChoiceCardProps,
+    "FormCard": FormCardProps,
+}
+
+__all__ = [
+    "COMPONENT_MODELS",
+    "CellPrimitive",
+    "ChoiceCardProps",
+    "ChoiceCardSubmit",
+    "ChoiceOption",
+    "FlexTableCell",
+    "FlexTableProps",
+    "FlexTableRow",
+    "FormCardProps",
+    "FormCardSubmit",
+    "FormField",
+    "FormFieldType",
+    "LatexFormulaProps",
+    "SimpleTableColumn",
+    "SimpleTableProps",
+    "SimpleTableRow",
+    "StrictModel",
+    "TextAlign",
+]

ai37_a2ui_catalog-0.3.0/src/ai37_a2ui_catalog/models/choice_card.py

@@ -0,0 +1,24 @@
+from __future__ import annotations
+
+from pydantic import Field
+
+from .shared import StrictModel
+
+
+class ChoiceOption(StrictModel):
+    label: str = Field(min_length=1, max_length=120)
+    value: str = Field(min_length=1, max_length=120)
+    description: str = Field(default=None, min_length=1, max_length=240)
+
+
+class ChoiceCardSubmit(StrictModel):
+    label: str = Field(min_length=1, max_length=80)
+    action: str = Field(min_length=1, max_length=120)
+
+
+class ChoiceCardProps(StrictModel):
+    title: str = Field(min_length=1, max_length=120)
+    description: str = Field(default=None, min_length=1, max_length=240)
+    multiple: bool = None
+    choices: list[ChoiceOption] = Field(min_length=1)
+    submit: ChoiceCardSubmit = None

ai37_a2ui_catalog-0.3.0/src/ai37_a2ui_catalog/models/flex_table.py

@@ -0,0 +1,72 @@
+from __future__ import annotations
+
+from typing import Literal
+
+from pydantic import Field, model_validator
+
+from .shared import StrictModel, TextAlign
+
+
+class FlexTableCell(StrictModel):
+    content: str = Field(min_length=1)
+    align: TextAlign = None
+    colSpan: int = Field(default=None, ge=1)
+    rowSpan: int = Field(default=None, ge=1)
+    emphasis: Literal["normal", "muted", "strong"] = None
+
+
+class FlexTableRow(StrictModel):
+    cells: list[FlexTableCell] = Field(min_length=1)
+
+
+def validate_header_grid(rows: list[FlexTableRow]) -> int:
+    total_columns = sum(cell.colSpan or 1 for cell in rows[0].cells)
+    active_spans = [0] * total_columns
+
+    for row_index, row in enumerate(rows):
+        if row_index > 0:
+            active_spans = [max(0, span - 1) for span in active_spans]
+
+        column_index = 0
+
+        for cell in row.cells:
+            while column_index < total_columns and active_spans[column_index] > 0:
+                column_index += 1
+
+            col_span = cell.colSpan or 1
+            row_span = cell.rowSpan or 1
+
+            if column_index + col_span > total_columns:
+                raise ValueError(f"Header row {row_index} exceeds the available column span.")
+
+            if any(active_spans[column_index + offset] > 0 for offset in range(col_span)):
+                raise ValueError(f"Header row {row_index} overlaps an active rowSpan.")
+
+            for offset in range(col_span):
+                active_spans[column_index + offset] = row_span
+
+            column_index += col_span
+
+        if any(span == 0 for span in active_spans):
+            raise ValueError(f"Header row {row_index} does not fully cover the table width.")
+
+    return total_columns
+
+
+class FlexTableProps(StrictModel):
+    title: str = Field(default=None, min_length=1, max_length=120)
+    caption: str = Field(default=None, min_length=1, max_length=240)
+    dense: bool = None
+    headerRows: list[FlexTableRow] = Field(min_length=1)
+    bodyRows: list[FlexTableRow] = Field(min_length=1)
+
+    @model_validator(mode="after")
+    def validate_row_spans(self) -> "FlexTableProps":
+        expected = validate_header_grid(self.headerRows)
+
+        for index, row in enumerate(self.bodyRows):
+            width = sum(cell.colSpan or 1 for cell in row.cells)
+            if width != expected:
+                raise ValueError(f"Body row {index} has inconsistent total span.")
+
+        return self

ai37_a2ui_catalog-0.3.0/src/ai37_a2ui_catalog/models/form_card.py

@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+from typing import Literal
+
+from pydantic import Field
+
+from .shared import StrictModel
+
+FormFieldType = Literal["text", "number", "select", "boolean"]
+
+
+class FormField(StrictModel):
+    name: str = Field(min_length=1, max_length=80)
+    label: str = Field(min_length=1, max_length=120)
+    type: FormFieldType
+    required: bool = None
+    options: list[str] = Field(default=None, min_length=1)
+    placeholder: str = Field(default=None, min_length=1, max_length=120)
+    defaultValue: str | int | float | bool = None
+
+
+class FormCardSubmit(StrictModel):
+    label: str = Field(min_length=1, max_length=80)
+    action: str = Field(min_length=1, max_length=120)
+
+
+class FormCardProps(StrictModel):
+    title: str = Field(min_length=1, max_length=120)
+    description: str = Field(default=None, min_length=1, max_length=240)
+    fields: list[FormField] = Field(min_length=1)
+    submit: FormCardSubmit

ai37_a2ui_catalog-0.3.0/src/ai37_a2ui_catalog/models/latex_formula.py

@@ -0,0 +1,13 @@
+from __future__ import annotations
+
+from pydantic import Field
+
+from .shared import StrictModel
+
+
+class LatexFormulaProps(StrictModel):
+    title: str = Field(default=None, min_length=1, max_length=120)
+    formula: str = Field(min_length=1)
+    displayMode: bool = None
+    annotation: str = Field(default=None, min_length=1, max_length=240)
+    bordered: bool = None

ai37_a2ui_catalog-0.3.0/src/ai37_a2ui_catalog/models/shared.py

@@ -0,0 +1,13 @@
+from __future__ import annotations
+
+from typing import Literal
+
+from pydantic import BaseModel, ConfigDict
+
+
+class StrictModel(BaseModel):
+    model_config = ConfigDict(extra="forbid")
+
+
+TextAlign = Literal["start", "center", "end"]
+CellPrimitive = str | int | float | bool | None

ai37_a2ui_catalog-0.3.0/src/ai37_a2ui_catalog/models/simple_table.py

@@ -0,0 +1,33 @@
+from __future__ import annotations
+
+from pydantic import Field, model_validator
+
+from .shared import CellPrimitive, StrictModel, TextAlign
+
+
+class SimpleTableColumn(StrictModel):
+    key: str = Field(min_length=1)
+    header: str = Field(min_length=1)
+    align: TextAlign = None
+    width: str = Field(default=None, min_length=1)
+
+
+class SimpleTableRow(StrictModel):
+    cells: list[CellPrimitive]
+
+
+class SimpleTableProps(StrictModel):
+    title: str = Field(default=None, min_length=1, max_length=120)
+    caption: str = Field(default=None, min_length=1, max_length=240)
+    compact: bool = None
+    striped: bool = None
+    columns: list[SimpleTableColumn] = Field(min_length=1)
+    rows: list[SimpleTableRow]
+
+    @model_validator(mode="after")
+    def validate_row_lengths(self) -> "SimpleTableProps":
+        expected = len(self.columns)
+        for index, row in enumerate(self.rows):
+            if len(row.cells) != expected:
+                raise ValueError(f"Row {index} must contain exactly {expected} cells.")
+        return self

ai37_a2ui_catalog-0.3.0/src/ai37_a2ui_catalog/validation.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+from typing import Any
+
+from .models import COMPONENT_MODELS
+
+
+def validate_component_payload(component: str, payload: dict[str, Any]):
+    model = COMPONENT_MODELS[component]
+    return model.model_validate(payload)
+
+
+def validate_component_payload_json(component: str, payload_json: str):
+    model = COMPONENT_MODELS[component]
+    return model.model_validate_json(payload_json)
+
+
+def get_component_schema(component: str) -> dict[str, Any]:
+    return COMPONENT_MODELS[component].model_json_schema()