sprout-toolkit 0.1.0__tar.gz

sprout_toolkit-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tzinny
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sprout_toolkit-0.1.0/PKG-INFO

@@ -0,0 +1,208 @@
+Metadata-Version: 2.4
+Name: sprout-toolkit
+Version: 0.1.0
+Summary: Generación procedural determinista de assets 2D para Expo + react-native-skia
+Author: Tzinny
+License: MIT License
+        
+        Copyright (c) 2026 Tzinny
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/Tzinny-dev/sprout-toolkit
+Project-URL: Repository, https://github.com/Tzinny-dev/sprout-toolkit
+Project-URL: Issues, https://github.com/Tzinny-dev/sprout-toolkit/issues
+Keywords: procgen,sprites,spritesheet,skia,expo,react-native,game-dev
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Games/Entertainment
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pillow>=10
+Requires-Dist: typer>=0.12
+Provides-Extra: test
+Requires-Dist: pytest>=8; extra == "test"
+Dynamic: license-file
+
+# sprout-toolkit
+
+**SPROUT** — Skia Procedural Rendering & Optimization Unified Toolkit
+
+> Grow your 2D assets procedurally.
+
+Sprout es un toolkit de código abierto para **generación procedural determinista de assets 2D**
+destinados a [Expo](https://expo.dev) + [`react-native-skia`](https://github.com/Shopify/react-native-skia).
+Genera atlases, mapas de tiles, autotiles, bitmap fonts y shaders SkSL a partir de specs JSON.
+
+---
+
+## Arquitectura
+
+```
+sprout/
+├── sprout/                     # Paquete Python
+│   ├── __init__.py             #   __version__
+│   ├── cli.py                  #   CLI (Typer): generate, batch, watch, info, lint, diff, validate
+│   ├── exporter.py             #   Spritesheet packing, manifest.json, index.ts
+│   ├── spec.py                 #   Carga/validación de specs JSON (schema v0)
+│   ├── autotile.py             #   Máscaras 8-bit, lookup 16/47
+│   ├── sksl.py                 #   Shaders SkSL runtime (FBM value-noise)
+│   ├── assets/fonts/           #   Fuente empaquetada (viaja en el wheel)
+│   └── generators/             #   Plugins de generación
+│       ├── base.py             #     FrameData + Generator (contrato)
+│       ├── terrain.py          #     Tiles seamless + autotile
+│       ├── props.py            #     Objetos estáticos (5 kinds, anchor points)
+│       ├── particles.py        #     Bursts animados con easing
+│       ├── ui.py                #     Botón, slider, panel 9-patch
+│       ├── font.py              #     Bitmap font desde TTF (un glifo por frame)
+│       └── blob_walk.py        #     8-frame walk cycle
+├── specs/                      # Specs de ejemplo (uno por generador)
+├── tests/                      # 142 tests (determinismo, autotile, SkSL, generadores, CLI)
+├── LICENSE                     # MIT
+└── pyproject.toml
+```
+
+## Características
+
+| Característica | Descripción |
+|---|---|
+| **Procgen determinista** | Seeds numéricas → assets reproducibles (testeable en CI). |
+| **Auto-tile 8-bit** | Máscara de autotile con 8 bits (N/E/S/W + diagonales), 16 o 47 variantes. |
+| **Bitmap fonts desde TTF** | Atlas de glifos con métricas de avance, listo para layout de texto. |
+| **Shaders SkSL runtime** | Shaders generados para Skia (FBM value-noise, tileable), sin engordar el bundle. |
+| **Introspección de specs** | `sprout info`/`sprout lint`/`sprout diff` para inspeccionar, validar calidad y comparar builds. |
+| **Exportación flexible** | PNG8/PNG24, formato TexturePacker, mipmaps del atlas — todo opt-in. |
+
+## Instalación
+
+```bash
+pip install sprout-toolkit
+# o en desarrollo:
+git clone https://github.com/Tzinny-dev/sprout-toolkit
+cd sprout-toolkit
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[test]"
+```
+
+El comando instalado es `sprout` (no `sprout-toolkit` — ese es solo el nombre de distribución en PyPI).
+
+## Uso rápido
+
+### Generar assets
+
+```bash
+# Generar todos los assets definidos en specs/
+sprout batch specs/ --out ./out
+
+# Generar un spec específico
+sprout generate specs/demo.json --out ./out
+
+# Modo watch: regenera al detectar cambios en specs/ (Ctrl-C para salir)
+sprout watch specs/ --out ./out --interval 1.0
+
+# Inspeccionar una spec (reporte humano o JSON)
+sprout info specs/particles.json
+sprout info --json specs/particles.json
+
+# Analizar calidad de una spec: padding de atlas + frames vacíos
+sprout lint specs/ui.json
+sprout lint --json specs/ui.json
+
+# Generar un atlas de bitmap font (ASCII imprimible, fuente empaquetada)
+sprout generate specs/font.json --out ./out
+
+# Comparar dos specs, o dos directorios de salida ya generados
+sprout diff specs/props.json specs/ui.json
+sprout diff --json ./out/a ./out/b
+
+# Validar un spec
+sprout validate specs/demo.json
+```
+
+### Opciones de exportación (`generate` / `batch`)
+
+```bash
+# PNG8 (paleta indexada, atlas más liviano) o PNG24 (sin alpha)
+sprout generate specs/ui.json --png-mode png8
+sprout generate specs/autotile.json --png-mode png24   # solo si el atlas no usa transparencia
+
+# Además de manifest.json, emite <name>.tpsheet.json (formato TexturePacker JSON Hash)
+sprout generate specs/props.json --texturepacker
+
+# Cadena de mip levels del atlas (@0.5x, @0.25x, @0.125x por defecto)
+sprout generate specs/particles.json --mipmaps
+sprout generate specs/particles.json --mipmaps --mipmap-levels 2
+```
+
+`--png-mode` default es `rgba` (sin cambios). `png8` cuantiza a 256 colores
+preservando el canal alpha (ideal para paletas acotadas tipo pixel-art);
+`png24` descarta el alpha por completo — solo usarlo en atlases sin
+transparencia real (p. ej. `terrain`). `--texturepacker`/`--mipmaps` son
+opt-in y no afectan `manifest.json`/`index.ts`, salvo que `--mipmaps`
+agrega el bloque `mipmaps.levels` al manifest.
+
+### Generadores disponibles
+
+| `generator` | Descripción | Params |
+|-------------|-------------|--------|
+| `terrain` | Tiles de ruido seamless + autotile 16/47 | `contrast`, `lift`, `cells`, `octaves`, `bevel`, `autotile` |
+| `blob_walk` | Ciclo de caminata de 8 frames (hero blob) | colores (`body`, `outline`, `belly`, ...) |
+| `props` | Objetos estáticos: `rock`, `bush`, `chest`, `mushroom`, `flower` — cada frame incluye un anchor point (`frames[].anchor` en el manifest, calculado desde el bbox alpha real) | `kind`, `fill`, `outline` |
+| `particles` | Bursts animados: `spark`, `smoke`, `dust`, `bubble` | `kind`, `particles`, `core`, `trail` |
+| `ui` | Interfaz: `button` (estados normal/hover/pressed), `slider` (progreso + knob), `panel` (9-patch, `frames=9`) | `kind`, `fill`, `outline`, `accent` |
+| `font` | Bitmap font desde TTF, un glifo por frame (`frames` = `len(chars)`) | `chars`, `font_path`, `size`, `fill` |
+
+Ejemplo de spec con `props`:
+
+```json
+{
+  "name": "props_atlas",
+  "seed": 2024,
+  "layout": { "framePx": 64, "cols": 6, "tileLogical": 32, "sample": "nearest" },
+  "items": [
+    { "id": "rock",  "generator": "props", "frames": 6, "params": { "kind": "rock" } },
+    { "id": "chest", "generator": "props", "frames": 4, "params": { "kind": "chest", "fill": [160, 110, 50] } }
+  ]
+}
+```
+
+## Desarrollo
+
+```bash
+pip install -e ".[test]"
+pytest -q
+```
+
+CI (`.github/workflows/tests.yml`) corre la suite completa en cada push/PR.
+
+## Créditos
+
+- `typer` + `Pillow` — CLI y generación de imágenes
+- **DejaVu Fonts** (`DejaVuSansMono-Bold.ttf`, empaquetada en `sprout/assets/fonts/`) —
+  licencia Bitstream Vera, ver `sprout/assets/fonts/DejaVuSansMono-Bold.LICENSE.txt`
+
+## Licencia
+
+MIT — ver [LICENSE](LICENSE).

sprout_toolkit-0.1.0/README.md

@@ -0,0 +1,160 @@
+# sprout-toolkit
+
+**SPROUT** — Skia Procedural Rendering & Optimization Unified Toolkit
+
+> Grow your 2D assets procedurally.
+
+Sprout es un toolkit de código abierto para **generación procedural determinista de assets 2D**
+destinados a [Expo](https://expo.dev) + [`react-native-skia`](https://github.com/Shopify/react-native-skia).
+Genera atlases, mapas de tiles, autotiles, bitmap fonts y shaders SkSL a partir de specs JSON.
+
+---
+
+## Arquitectura
+
+```
+sprout/
+├── sprout/                     # Paquete Python
+│   ├── __init__.py             #   __version__
+│   ├── cli.py                  #   CLI (Typer): generate, batch, watch, info, lint, diff, validate
+│   ├── exporter.py             #   Spritesheet packing, manifest.json, index.ts
+│   ├── spec.py                 #   Carga/validación de specs JSON (schema v0)
+│   ├── autotile.py             #   Máscaras 8-bit, lookup 16/47
+│   ├── sksl.py                 #   Shaders SkSL runtime (FBM value-noise)
+│   ├── assets/fonts/           #   Fuente empaquetada (viaja en el wheel)
+│   └── generators/             #   Plugins de generación
+│       ├── base.py             #     FrameData + Generator (contrato)
+│       ├── terrain.py          #     Tiles seamless + autotile
+│       ├── props.py            #     Objetos estáticos (5 kinds, anchor points)
+│       ├── particles.py        #     Bursts animados con easing
+│       ├── ui.py                #     Botón, slider, panel 9-patch
+│       ├── font.py              #     Bitmap font desde TTF (un glifo por frame)
+│       └── blob_walk.py        #     8-frame walk cycle
+├── specs/                      # Specs de ejemplo (uno por generador)
+├── tests/                      # 142 tests (determinismo, autotile, SkSL, generadores, CLI)
+├── LICENSE                     # MIT
+└── pyproject.toml
+```
+
+## Características
+
+| Característica | Descripción |
+|---|---|
+| **Procgen determinista** | Seeds numéricas → assets reproducibles (testeable en CI). |
+| **Auto-tile 8-bit** | Máscara de autotile con 8 bits (N/E/S/W + diagonales), 16 o 47 variantes. |
+| **Bitmap fonts desde TTF** | Atlas de glifos con métricas de avance, listo para layout de texto. |
+| **Shaders SkSL runtime** | Shaders generados para Skia (FBM value-noise, tileable), sin engordar el bundle. |
+| **Introspección de specs** | `sprout info`/`sprout lint`/`sprout diff` para inspeccionar, validar calidad y comparar builds. |
+| **Exportación flexible** | PNG8/PNG24, formato TexturePacker, mipmaps del atlas — todo opt-in. |
+
+## Instalación
+
+```bash
+pip install sprout-toolkit
+# o en desarrollo:
+git clone https://github.com/Tzinny-dev/sprout-toolkit
+cd sprout-toolkit
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[test]"
+```
+
+El comando instalado es `sprout` (no `sprout-toolkit` — ese es solo el nombre de distribución en PyPI).
+
+## Uso rápido
+
+### Generar assets
+
+```bash
+# Generar todos los assets definidos en specs/
+sprout batch specs/ --out ./out
+
+# Generar un spec específico
+sprout generate specs/demo.json --out ./out
+
+# Modo watch: regenera al detectar cambios en specs/ (Ctrl-C para salir)
+sprout watch specs/ --out ./out --interval 1.0
+
+# Inspeccionar una spec (reporte humano o JSON)
+sprout info specs/particles.json
+sprout info --json specs/particles.json
+
+# Analizar calidad de una spec: padding de atlas + frames vacíos
+sprout lint specs/ui.json
+sprout lint --json specs/ui.json
+
+# Generar un atlas de bitmap font (ASCII imprimible, fuente empaquetada)
+sprout generate specs/font.json --out ./out
+
+# Comparar dos specs, o dos directorios de salida ya generados
+sprout diff specs/props.json specs/ui.json
+sprout diff --json ./out/a ./out/b
+
+# Validar un spec
+sprout validate specs/demo.json
+```
+
+### Opciones de exportación (`generate` / `batch`)
+
+```bash
+# PNG8 (paleta indexada, atlas más liviano) o PNG24 (sin alpha)
+sprout generate specs/ui.json --png-mode png8
+sprout generate specs/autotile.json --png-mode png24   # solo si el atlas no usa transparencia
+
+# Además de manifest.json, emite <name>.tpsheet.json (formato TexturePacker JSON Hash)
+sprout generate specs/props.json --texturepacker
+
+# Cadena de mip levels del atlas (@0.5x, @0.25x, @0.125x por defecto)
+sprout generate specs/particles.json --mipmaps
+sprout generate specs/particles.json --mipmaps --mipmap-levels 2
+```
+
+`--png-mode` default es `rgba` (sin cambios). `png8` cuantiza a 256 colores
+preservando el canal alpha (ideal para paletas acotadas tipo pixel-art);
+`png24` descarta el alpha por completo — solo usarlo en atlases sin
+transparencia real (p. ej. `terrain`). `--texturepacker`/`--mipmaps` son
+opt-in y no afectan `manifest.json`/`index.ts`, salvo que `--mipmaps`
+agrega el bloque `mipmaps.levels` al manifest.
+
+### Generadores disponibles
+
+| `generator` | Descripción | Params |
+|-------------|-------------|--------|
+| `terrain` | Tiles de ruido seamless + autotile 16/47 | `contrast`, `lift`, `cells`, `octaves`, `bevel`, `autotile` |
+| `blob_walk` | Ciclo de caminata de 8 frames (hero blob) | colores (`body`, `outline`, `belly`, ...) |
+| `props` | Objetos estáticos: `rock`, `bush`, `chest`, `mushroom`, `flower` — cada frame incluye un anchor point (`frames[].anchor` en el manifest, calculado desde el bbox alpha real) | `kind`, `fill`, `outline` |
+| `particles` | Bursts animados: `spark`, `smoke`, `dust`, `bubble` | `kind`, `particles`, `core`, `trail` |
+| `ui` | Interfaz: `button` (estados normal/hover/pressed), `slider` (progreso + knob), `panel` (9-patch, `frames=9`) | `kind`, `fill`, `outline`, `accent` |
+| `font` | Bitmap font desde TTF, un glifo por frame (`frames` = `len(chars)`) | `chars`, `font_path`, `size`, `fill` |
+
+Ejemplo de spec con `props`:
+
+```json
+{
+  "name": "props_atlas",
+  "seed": 2024,
+  "layout": { "framePx": 64, "cols": 6, "tileLogical": 32, "sample": "nearest" },
+  "items": [
+    { "id": "rock",  "generator": "props", "frames": 6, "params": { "kind": "rock" } },
+    { "id": "chest", "generator": "props", "frames": 4, "params": { "kind": "chest", "fill": [160, 110, 50] } }
+  ]
+}
+```
+
+## Desarrollo
+
+```bash
+pip install -e ".[test]"
+pytest -q
+```
+
+CI (`.github/workflows/tests.yml`) corre la suite completa en cada push/PR.
+
+## Créditos
+
+- `typer` + `Pillow` — CLI y generación de imágenes
+- **DejaVu Fonts** (`DejaVuSansMono-Bold.ttf`, empaquetada en `sprout/assets/fonts/`) —
+  licencia Bitstream Vera, ver `sprout/assets/fonts/DejaVuSansMono-Bold.LICENSE.txt`
+
+## Licencia
+
+MIT — ver [LICENSE](LICENSE).

sprout_toolkit-0.1.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sprout-toolkit"
+version = "0.1.0"
+description = "Generación procedural determinista de assets 2D para Expo + react-native-skia"
+readme = "README.md"
+authors = [{ name = "Tzinny" }]
+requires-python = ">=3.10"
+license = { file = "LICENSE" }
+keywords = ["procgen", "sprites", "spritesheet", "skia", "expo", "react-native", "game-dev"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Games/Entertainment",
+    "Topic :: Multimedia :: Graphics",
+    "Topic :: Software Development :: Code Generators",
+]
+dependencies = [
+    "pillow>=10",
+    "typer>=0.12",
+]
+
+[project.urls]
+Homepage = "https://github.com/Tzinny-dev/sprout-toolkit"
+Repository = "https://github.com/Tzinny-dev/sprout-toolkit"
+Issues = "https://github.com/Tzinny-dev/sprout-toolkit/issues"
+
+[project.optional-dependencies]
+test = ["pytest>=8"]
+
+[project.scripts]
+sprout = "sprout.cli:app"
+
+[tool.setuptools.packages.find]
+include = ["sprout*"]
+
+[tool.setuptools.package-data]
+sprout = ["assets/fonts/*.ttf", "assets/fonts/*.txt"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

sprout_toolkit-0.1.0/setup.cfg

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

sprout_toolkit-0.1.0/sprout/__init__.py

@@ -0,0 +1,3 @@
+"""sprout — toolchain determinista de assets 2D procedurales para Expo + react-native-skia."""
+
+__version__ = "0.1.0"

sprout_toolkit-0.1.0/sprout/assets/fonts/DejaVuSansMono-Bold.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'.

sprout_toolkit-0.1.0/sprout/autotile.py

@@ -0,0 +1,57 @@
+"""Autotiling 16 / 47 — reducción canónica de máscaras de vecindad 8-bit.
+
+Bits (convención canónica sprout, ver INVESTIGACION.md §5.3)::
+
+    N=1, NE=2, E=4, SE=8, S=16, SW=32, W=64, NW=128
+
+El bit diagonal solo cuenta si **ambos** cardinales adyacentes están presentes:
+así 2**8 = 256 vecindades colapsan a 47. Un "corner bit" describe el cuadrante
+donde se juntan sus dos lados; si falta un lado, ese cuadrante ya es borde
+exterior y la diagonal no aporta una silueta distinta.
+
+Referencia verificada contra Godot 4.7 (Blobsmith Autotile Wirer, MIT):
+https://github.com/leobaray/blobsmith-autotile-wirer/blob/master/docs/why-47-tiles-not-256.md
+"""
+from __future__ import annotations
+
+N, NE, E, SE, S, SW, W, NW = 1, 2, 4, 8, 16, 32, 64, 128
+
+SIDES = N | E | S | W  # 0b01010101 == 85
+CORNERS = NE | SE | SW | NW
+
+BITMASK = "N1,E4,S16,W64,NE2,SE8,SW32,NW128"
+
+
+def canonical_47(mask: int) -> int:
+    """Máscara canónica del sistema 8-bit (47 clases)."""
+    m = mask & SIDES
+    if (mask & NE) and (mask & N) and (mask & E):
+        m |= NE
+    if (mask & SE) and (mask & S) and (mask & E):
+        m |= SE
+    if (mask & SW) and (mask & S) and (mask & W):
+        m |= SW
+    if (mask & NW) and (mask & N) and (mask & W):
+        m |= NW
+    return m
+
+
+def canonical_16(mask: int) -> int:
+    """Máscara canónica del sistema cardinal (16 clases, Match Sides)."""
+    return mask & SIDES
+
+
+def canonical(mask: int, size: int) -> int:
+    if size == 16:
+        return canonical_16(mask)
+    if size == 47:
+        return canonical_47(mask)
+    raise ValueError(f"autotile no soportado: {size!r} (esperado 16 | 47)")
+
+
+def masks(size: int) -> list[int]:
+    """Máscaras canónicas en orden ascendente = orden de la hoja (cols=8)."""
+    fn = {16: canonical_16, 47: canonical_47}.get(size)
+    if fn is None:
+        raise ValueError(f"autotile no soportado: {size!r} (esperado 16 | 47)")
+    return [m for m in range(256) if fn(m) == m]