Skip to content

Screen type descriptor 0.1

Schema reference / Screen type descriptor / 0.1

Source kind, planar geometry, resolution, colour/alpha, refresh ceiling and input support for a screen type.

Status
Latest
Published
2026-10-07
Title
“Hyprune v0 screen-type”
Dialect
JSON Schema 2020-12 · unknown fields rejected unless marked
Raw schemascreen-type.schema.json · 115 lines · 2.1 KB
DownloadOpen rawsha256 dbe01adbe14c…
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://hyprune.com/schema/v0/screen-type.schema.json",
"title": "Hyprune v0 screen-type",
"type": "object",
"properties": {
"descriptorVersion": {
"const": "0.1"
},
"id": {
"$ref": "common.schema.json#/$defs/id"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"provider": {
"$ref": "common.schema.json#/$defs/id"
},
"source": {
"enum": [
"window",
"workspace",
"layer",
"web",
"custom"
]
},
"geometry": {
"const": "plane"
},
"defaultSize": {
"type": "array",
"items": {
"type": "number",
"exclusiveMinimum": 0
},
"minItems": 2,
"maxItems": 2
},
"resolution": {
"type": "object",
"properties": {
"width": {
"type": "integer",
"minimum": 1,
"maximum": 8192
},
"height": {
"type": "integer",
"minimum": 1,
"maximum": 8192
}
},
"required": [
"width",
"height"
],
"additionalProperties": false
},
"input": {
"type": "object",
"properties": {
"pointer": {
"type": "boolean"
},
"keyboard": {
"type": "boolean"
},
"touch": {
"const": false
}
},
"required": [
"pointer",
"keyboard",
"touch"
],
"additionalProperties": false
},
"alphaMode": {
"enum": [
"opaque",
"blend"
]
},
"colorSpace": {
"const": "srgb"
},
"maxFps": {
"type": "integer",
"minimum": 1,
"maximum": 120
},
"extensions": {
"$ref": "common.schema.json#/$defs/extensions"
}
},
"required": [
"descriptorVersion",
"id",
"name",
"provider",
"source",
"geometry",
"defaultSize",
"resolution",
"input",
"alphaMode",
"colorSpace",
"maxFps"
],
"additionalProperties": false
}

This is the first published version of this contract.

Fields

FieldTypeConstraints
descriptorVersionrequired"0.1"
idrequiredid
namerequiredstringlength 1–256
providerrequiredid
sourcerequired"window" | "workspace" | "layer" | "web" | "custom"
geometryrequired"plane"
defaultSizerequirednumber[2]each > 0
resolutionrequiredobject
widthrequiredinteger≥ 1 · ≤ 8192
heightrequiredinteger≥ 1 · ≤ 8192
inputrequiredobject
pointerrequiredboolean
keyboardrequiredboolean
touchrequiredfalse
alphaModerequired"opaque" | "blend"
colorSpacerequired"srgb"
maxFpsrequiredinteger≥ 1 · ≤ 120
extensionsextensions

Examples

Offline fixtures from the schema repository, validated by its test suite. They show shape, not a real session or package.

screen-type.jsonscreen-type.json · 24 lines · 420 B
{
"descriptorVersion": "0.1",
"id": "com.hyprune.window",
"name": "Application window",
"provider": "com.hyprune.core",
"source": "window",
"geometry": "plane",
"defaultSize": [
1.6,
0.9
],
"resolution": {
"width": 1920,
"height": 1080
},
"input": {
"pointer": true,
"keyboard": true,
"touch": false
},
"alphaMode": "blend",
"colorSpace": "srgb",
"maxFps": 60
}

Mirrored byte-for-byte from hyprune/schema at 34849da45183 (2026-10-15). SHA-256 dbe01adbe14c139db458a562887dbf0960031b6312b1ca460fee7391833d5851.