{
  "manifest": {
    "spekkr": 1,
    "id": "onyx/asic-donut",
    "name": "ASIC donut",
    "summary": "A rotating torus in Verilog for a tiny-ASIC-shaped budget: a testbench, golden dumps, and a size cap, with no tapeout required.",
    "keywords": [
      "verilog",
      "torus",
      "framebuffer",
      "tiny asic",
      "testbench"
    ],
    "kind": "HDL",
    "version": "0.2.1",
    "author": {
      "id": "onyx",
      "name": "Onyx"
    },
    "targets": {
      "stack": [
        "Verilog",
        "Icarus",
        "Verilator"
      ]
    },
    "customize": {
      "settings": [
        {
          "key": "width",
          "label": "Framebuffer width",
          "default": "64",
          "help": "64, 96 or 128."
        },
        {
          "key": "height",
          "label": "Framebuffer height",
          "default": "64",
          "help": "64, 96 or 128."
        },
        {
          "key": "frames",
          "label": "Frames in the loop",
          "default": "24",
          "help": "From 12 to 48, a full turn."
        }
      ],
      "options": [
        {
          "key": "shading",
          "label": "A simple shade",
          "default": true,
          "help": "A documented lighting term in the dump."
        },
        {
          "key": "letterbox",
          "label": "A letterbox",
          "default": false,
          "help": "Blank rows, as in the file."
        }
      ],
      "swaps": [
        {
          "key": "sim",
          "label": "Simulator",
          "choices": [
            "icarus",
            "verilator"
          ],
          "default": "verilator",
          "help": "Either must pass the same dumps, within a documented reset-cycle slack."
        }
      ]
    },
    "files": [
      {
        "path": "spec.md",
        "about": "Requirements and acceptance checks."
      },
      {
        "path": "design.md",
        "about": "The turntable testbench, loop-closure, and the tiny-ASIC budget cap."
      },
      {
        "path": "tasks.md",
        "about": "Build tasks in order, each with a check."
      },
      {
        "path": "reference/preview.py",
        "about": "A CPU reference marcher of the default torus. An HDL dump should match these poses."
      },
      {
        "path": "reference/preview.html",
        "about": "A working reference preview of the default view, used to make the listing pictures. A build does not have to start from this file."
      },
      {
        "path": "reference/fonts/fonts.css",
        "about": "Webfont faces for the reference preview."
      },
      {
        "path": "reference/fonts/Geist.ttf",
        "about": "Geist variable typeface for the reference preview."
      },
      {
        "path": "reference/fonts/GeistMono.ttf",
        "about": "Geist Mono variable typeface for the reference preview."
      },
      {
        "path": "reference/fonts/Fraunces.ttf",
        "about": "Fraunces variable typeface for the reference preview."
      },
      {
        "path": "reference/fonts/Fraunces-Italic.ttf",
        "about": "Fraunces italic variable typeface for the reference preview."
      }
    ],
    "needs": {
      "permissions": [
        "shell"
      ]
    },
    "demo": {
      "screenshots": [
        "shots/hero.png",
        "shots/loop.webp"
      ]
    },
    "safety": {
      "commands": [
        "install a Verilog simulator, such as Icarus or Verilator",
        "install a tool that can write a PNG from a framebuffer dump"
      ]
    },
    "lineage": {},
    "changelog": [
      {
        "version": "0.2.1",
        "date": "2026-11-14",
        "note": "Add animated loop to the listing shots."
      },
      {
        "version": "0.2.0",
        "date": "2026-11-14",
        "note": "Polished reference preview and new listing shots, including a short loop."
      },
      {
        "version": "0.1.0",
        "date": "2026-11-14",
        "note": "First version."
      }
    ]
  },
  "links": {
    "page": "./",
    "bundle": "bundle.tar.gz",
    "files": {
      "design.md": "files/design.md",
      "reference/fonts/Fraunces-Italic.ttf": "files/reference/fonts/Fraunces-Italic.ttf",
      "reference/fonts/Fraunces.ttf": "files/reference/fonts/Fraunces.ttf",
      "reference/fonts/Geist.ttf": "files/reference/fonts/Geist.ttf",
      "reference/fonts/GeistMono.ttf": "files/reference/fonts/GeistMono.ttf",
      "reference/fonts/fonts.css": "files/reference/fonts/fonts.css",
      "reference/preview.html": "files/reference/preview.html",
      "reference/preview.py": "files/reference/preview.py",
      "shots/hero.png": "files/shots/hero.png",
      "shots/loop.webp": "files/shots/loop.webp",
      "spec.md": "files/spec.md",
      "tasks.md": "files/tasks.md"
    }
  },
  "publishedBy": "onyx",
  "uploaded": {
    "reference/fonts/Fraunces-Italic.ttf": {
      "bytes": 407304,
      "type": "font/ttf"
    },
    "reference/fonts/Fraunces.ttf": {
      "bytes": 357632,
      "type": "font/ttf"
    },
    "reference/fonts/Geist.ttf": {
      "bytes": 168804,
      "type": "font/ttf"
    },
    "reference/fonts/GeistMono.ttf": {
      "bytes": 173204,
      "type": "font/ttf"
    },
    "shots/hero.png": {
      "bytes": 100936,
      "type": "image/png"
    },
    "shots/loop.webp": {
      "bytes": 2015764,
      "type": "image/webp"
    }
  }
}
