@hyprune/schema 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -463,3 +463,15 @@ Publishes IPC 0.24: `objects.catalog` entries carry a placed machine's declared
 ## @hyprune/schema 0.10.0 (2026-10-13)
 
 Publishes IPC 0.25: companions. `companion.set`, `companion.clear` and `companion.mode` (follow or stay), a required `companion` state key, a companion capability on catalog entries and the aimed interaction type `companion`; and the object 0.10 draft `companion` block (name, followDistance, idles, say). Inherits 0.24.
+
+## @hyprune/schema 0.11.0 (2026-10-13): registry documents
+
+Registry documents (RFC-0015), versioned independently under `registry/v0.1/`:
+`index.schema.json` (index documents; `$defs.entry` for registry entry files),
+`release-record.schema.json` and `sources.schema.json`. `validateRegistry(kind, doc,
+version?)` for kinds `registry-index`, `registry-entry`, `release-record` and `sources`
+checks unique ids, versions unique and newest first (SemVer, no build metadata), tags
+naming their version (`v<version>` or `<name>-v<version>`), SPDX licences, per-type
+archive limits and custom source rules. New exports: `registryVersions`,
+`registryLimits`, `parseSemver`, `compareSemver`, `tagVersion`. The CLI accepts the four
+registry kinds. The package ships `registry/`. World formats and IPC are unchanged.

package/README.md

@@ -32,6 +32,29 @@ Every schema file is importable at `@hyprune/schema/v0.N/<name>.schema.json` (`v
 
 [RFC source](https://github.com/hyprune/docs/tree/main/src/content/docs/rfcs) is normative for semantics. [RFC-0003](https://hyprune.com/rfcs/0003-ipc/) defines IPC; [RFC-0004](https://hyprune.com/rfcs/0004-world-format/) defines worlds. The `$id` URLs are mirrored by docs for authoring; this validator registers all schemas locally and never fetches them.
 
+## Registry documents (RFC-0015)
+
+Registry formats are versioned on their own, under `registry/v0.N/` (first: `0.1`):
+
+| Schema | Describes |
+| --- | --- |
+| `registry/v0.1/index.schema.json` | An index (official, community registry or any third-party index). `$defs.entry` is one entry and the shape of a registry entry file, which may add a `$schema` pointer. |
+| `registry/v0.1/release-record.schema.json` | `<id>-<version>.release.json`, the record published with each release. |
+| `registry/v0.1/sources.schema.json` | `sources.json` and the read-only files listed in `HYPRUNE_SOURCES_FILES`. |
+
+```js
+import { validateRegistry, compareSemver, tagVersion } from '@hyprune/schema';
+validateRegistry('registry-index', index);   // also 'registry-entry', 'release-record', 'sources'
+tagVersion('lumen-reach-v0.10.2');           // { name: 'lumen-reach', version: '0.10.2' }
+```
+
+`validateRegistry` adds the rules a schema can't express: ids unique within an index,
+versions unique and newest first by SemVer, each tag naming its version (`v<version>` or
+`<name>-v<version>`), SPDX licences, per-type archive limits (`registryLimits`), release
+record asset names, and unique, non-reserved custom source ids. CLI:
+`npm run validate -- registry-index index.json` (indexes up to 16 MiB). Fixtures:
+`examples/registry/` (valid) and `examples/registry/invalid/<kind>--<case>.json`.
+
 ## Validate
 
 Use Node >=22.12 (CI pins 24.14.0), npm, and the committed lockfile:

package/bin/validate.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { readFileSync } from 'node:fs';
-import { validate } from '../lib/validate.mjs';
+import { validate, validateRegistry } from '../lib/validate.mjs';
+const registryKinds = ['registry-index', 'registry-entry', 'release-record', 'sources'];
 const [kind, file, method, version, worldFile, asset, ...extra] = process.argv.slice(2);
 // For kind `object` the fifth argument is the object's glTF (.gltf or .glb) for the cross-checks.
 const gltfJson = path => {
@@ -9,19 +10,24 @@ const gltfJson = path => {
   if (bytes.length < 20 || bytes.readUInt32LE(0) !== 0x46546c67 || bytes.readUInt32LE(16) !== 0x4e4f534a) throw new Error('Invalid GLB header/JSON chunk');
   return JSON.parse(bytes.subarray(20, 20 + bytes.readUInt32LE(12)).toString('utf8'));
 };
-if (!kind || !file || extra.length || ((worldFile || asset) && kind !== 'scene' && kind !== 'object') || (asset && kind === 'object')) {
+if (!kind || !file || extra.length || ((worldFile || asset) && kind !== 'scene' && kind !== 'object') || (asset && kind === 'object') ||
+    (registryKinds.includes(kind) && method && method !== '-')) {
   console.error('Usage: hyprune-validate <world|extension|screen-type|ipc> <file.json|-> [response-method|-] [contract-version]\n' +
                 '       hyprune-validate scene <scene.gltf> - <world-format> <world.json> [object-asset-id]\n' +
-                '       hyprune-validate <object|library|library-releases> <file.json|-> [-] [format] [object scene.gltf|.glb]\n(in this repository: npm run validate -- ...)');
+                '       hyprune-validate <object|library|library-releases> <file.json|-> [-] [format] [object scene.gltf|.glb]\n' +
+                '       hyprune-validate <registry-index|registry-entry|release-record|sources> <file.json|-> [-] [registry version]\n(in this repository: npm run validate -- ...)');
   process.exitCode = 2;
 } else {
   try {
     const bytes = readFileSync(file === '-' ? 0 : file);
-    if (bytes.length > 1_048_576) throw new Error('Document exceeds 1 MiB');
+    // Indexes may be up to 16 MiB as served (RFC-0015); every other document 1 MiB.
+    const cap = kind === 'registry-index' ? 16 * 1_048_576 : 1_048_576;
+    if (bytes.length > cap) throw new Error(`Document exceeds ${cap / 1_048_576} MiB`);
     const value = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes));
     const options = kind === 'object' ? { gltf: worldFile ? gltfJson(worldFile) : undefined }
       : { world: worldFile ? JSON.parse(readFileSync(worldFile, 'utf8')) : undefined, asset };
-    const result = validate(kind, value, method === '-' ? undefined : method, version || undefined, options);
+    const result = registryKinds.includes(kind) ? validateRegistry(kind, value, version || undefined)
+      : validate(kind, value, method === '-' ? undefined : method, version || undefined, options);
     for (const warning of result.warnings || []) console.error(`warning: ${warning}`);
     if (result.valid) console.log(`VALID ${kind}: ${file}`);
     else { console.error(result.errors.join('\n')); process.exitCode = 1; }

package/examples/registry/entry.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "https://hyprune.com/schema/registry/v0.1/index.schema.json#/$defs/entry",
+  "id": "io.github.example-creator.tidepool",
+  "type": "world",
+  "name": "Tidepool Station",
+  "summary": "A tidal research station with four workspace homes and a pier.",
+  "description": "Four connected homes around a flooded atrium.\nA pier with a long view.",
+  "creator": "example-creator",
+  "repo": "https://github.com/example-creator/tidepool-world",
+  "tags": [
+    "water",
+    "station"
+  ],
+  "versions": [
+    {
+      "tag": "v1.2.0",
+      "version": "1.2.0",
+      "formatVersion": "0.9",
+      "published": "2026-11-01",
+      "license": "CC-BY-SA-4.0",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    },
+    {
+      "tag": "v1.2.0-rc.1",
+      "version": "1.2.0-rc.1",
+      "formatVersion": "0.9",
+      "published": "2026-10-28",
+      "license": "CC-BY-SA-4.0",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    },
+    {
+      "tag": "v1.1.0",
+      "version": "1.1.0",
+      "formatVersion": "0.9",
+      "published": "2026-10-20",
+      "license": "CC-BY-SA-4.0",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    }
+  ]
+}

package/examples/registry/index.json

@@ -0,0 +1,137 @@
+{
+  "indexVersion": "0.1",
+  "name": "Example community index",
+  "homepage": "https://example.org/hyprune",
+  "serial": 1842,
+  "generated": "2026-11-02T08:00:00Z",
+  "successor": null,
+  "entries": [
+    {
+      "id": "io.github.example-creator.tidepool",
+      "type": "world",
+      "name": "Tidepool Station",
+      "summary": "A tidal research station with four workspace homes and a pier.",
+      "description": "Four connected homes around a flooded atrium.\nA pier with a long view.",
+      "creator": "example-creator",
+      "repo": "https://github.com/example-creator/tidepool-world",
+      "tags": [
+        "water",
+        "station"
+      ],
+      "versions": [
+        {
+          "tag": "v1.2.0",
+          "version": "1.2.0",
+          "formatVersion": "0.9",
+          "published": "2026-11-01",
+          "license": "CC-BY-SA-4.0",
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.tar.zst",
+          "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+          "bytes": 48213004,
+          "expandedBytes": 96424960,
+          "files": 212,
+          "record": {
+            "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.release.json",
+            "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+          },
+          "requires": {
+            "libraries": [
+              "com.example.street@1.2.0"
+            ]
+          },
+          "thumbnails": [
+            {
+              "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.thumb-1.png",
+              "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+              "width": 1280,
+              "height": 720
+            }
+          ],
+          "status": "available"
+        },
+        {
+          "tag": "v1.2.0-rc.1",
+          "version": "1.2.0-rc.1",
+          "formatVersion": "0.9",
+          "published": "2026-10-28",
+          "license": "CC-BY-SA-4.0",
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.tar.zst",
+          "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+          "bytes": 48213004,
+          "expandedBytes": 96424960,
+          "files": 212,
+          "record": {
+            "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.release.json",
+            "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+          },
+          "requires": {
+            "libraries": [
+              "com.example.street@1.2.0"
+            ]
+          },
+          "thumbnails": [
+            {
+              "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.thumb-1.png",
+              "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+              "width": 1280,
+              "height": 720
+            }
+          ],
+          "status": "available"
+        },
+        {
+          "tag": "v1.1.0",
+          "version": "1.1.0",
+          "formatVersion": "0.9",
+          "published": "2026-10-20",
+          "license": "CC-BY-SA-4.0",
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.tar.zst",
+          "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+          "bytes": 48213004,
+          "expandedBytes": 96424960,
+          "files": 212,
+          "record": {
+            "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.release.json",
+            "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+          },
+          "requires": {
+            "libraries": [
+              "com.example.street@1.2.0"
+            ]
+          },
+          "thumbnails": [
+            {
+              "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.thumb-1.png",
+              "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+              "width": 1280,
+              "height": 720
+            }
+          ],
+          "status": "available"
+        }
+      ]
+    },
+    {
+      "id": "com.example.street",
+      "type": "library",
+      "name": "Street kit",
+      "summary": "Lanterns and benches.",
+      "creator": "example-org",
+      "repo": "https://github.com/example-org/hyprune-objects",
+      "versions": [
+        {
+          "tag": "street-v1.2.0",
+          "version": "1.2.0",
+          "formatVersion": "0.10",
+          "published": "2026-10-30",
+          "license": "CC0-1.0",
+          "url": "https://github.com/example-org/hyprune-objects/releases/download/street-v1.2.0/com.example.street-1.2.0.tar.zst",
+          "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+          "bytes": 3108221,
+          "expandedBytes": 7340032,
+          "files": 24
+        }
+      ]
+    }
+  ]
+}

package/examples/registry/invalid/registry-entry--bad-spdx.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "https://hyprune.com/schema/registry/v0.1/index.schema.json#/$defs/entry",
+  "id": "io.github.example-creator.tidepool",
+  "type": "world",
+  "name": "Tidepool Station",
+  "summary": "A tidal research station with four workspace homes and a pier.",
+  "description": "Four connected homes around a flooded atrium.\nA pier with a long view.",
+  "creator": "example-creator",
+  "repo": "https://github.com/example-creator/tidepool-world",
+  "tags": [
+    "water",
+    "station"
+  ],
+  "versions": [
+    {
+      "tag": "v1.2.0",
+      "version": "1.2.0",
+      "formatVersion": "0.9",
+      "published": "2026-11-01",
+      "license": "Free for everyone",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    },
+    {
+      "tag": "v1.2.0-rc.1",
+      "version": "1.2.0-rc.1",
+      "formatVersion": "0.9",
+      "published": "2026-10-28",
+      "license": "CC-BY-SA-4.0",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    },
+    {
+      "tag": "v1.1.0",
+      "version": "1.1.0",
+      "formatVersion": "0.9",
+      "published": "2026-10-20",
+      "license": "CC-BY-SA-4.0",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    }
+  ]
+}

package/examples/registry/invalid/registry-entry--build-metadata.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "https://hyprune.com/schema/registry/v0.1/index.schema.json#/$defs/entry",
+  "id": "io.github.example-creator.tidepool",
+  "type": "world",
+  "name": "Tidepool Station",
+  "summary": "A tidal research station with four workspace homes and a pier.",
+  "description": "Four connected homes around a flooded atrium.\nA pier with a long view.",
+  "creator": "example-creator",
+  "repo": "https://github.com/example-creator/tidepool-world",
+  "tags": [
+    "water",
+    "station"
+  ],
+  "versions": [
+    {
+      "tag": "v1.2.0+build.5",
+      "version": "1.2.0+build.5",
+      "formatVersion": "0.9",
+      "published": "2026-11-01",
+      "license": "CC-BY-SA-4.0",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    },
+    {
+      "tag": "v1.2.0-rc.1",
+      "version": "1.2.0-rc.1",
+      "formatVersion": "0.9",
+      "published": "2026-10-28",
+      "license": "CC-BY-SA-4.0",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    },
+    {
+      "tag": "v1.1.0",
+      "version": "1.1.0",
+      "formatVersion": "0.9",
+      "published": "2026-10-20",
+      "license": "CC-BY-SA-4.0",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    }
+  ]
+}

package/examples/registry/invalid/registry-entry--control-characters.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "https://hyprune.com/schema/registry/v0.1/index.schema.json#/$defs/entry",
+  "id": "io.github.example-creator.tidepool",
+  "type": "world",
+  "name": "Tidepool Station",
+  "summary": "line\nbreak",
+  "description": "Four connected homes around a flooded atrium.\nA pier with a long view.",
+  "creator": "example-creator",
+  "repo": "https://github.com/example-creator/tidepool-world",
+  "tags": [
+    "water",
+    "station"
+  ],
+  "versions": [
+    {
+      "tag": "v1.2.0",
+      "version": "1.2.0",
+      "formatVersion": "0.9",
+      "published": "2026-11-01",
+      "license": "CC-BY-SA-4.0",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    },
+    {
+      "tag": "v1.2.0-rc.1",
+      "version": "1.2.0-rc.1",
+      "formatVersion": "0.9",
+      "published": "2026-10-28",
+      "license": "CC-BY-SA-4.0",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    },
+    {
+      "tag": "v1.1.0",
+      "version": "1.1.0",
+      "formatVersion": "0.9",
+      "published": "2026-10-20",
+      "license": "CC-BY-SA-4.0",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    }
+  ]
+}