@jami-studio/registry-schema 0.1.0

package/src/schemas/theme-ref.schema.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://jami.studio/schemas/registry/theme-ref.schema.json",
+  "title": "themeRef",
+  "description": "Studio UI side of the theme handshake. Identifies a theme registry item by registryRef and its factory/custom/default kind. Mirrors the Jami Harness theme-ref so both sides resolve the same registry identity.",
+  "type": "object",
+  "required": ["themeId", "registryRef", "kind"],
+  "additionalProperties": false,
+  "properties": {
+    "themeId": {
+      "type": "string",
+      "pattern": "^theme_[a-z0-9][a-z0-9_-]*$"
+    },
+    "tokenSchemaVersion": { "type": "string" },
+    "registryRef": { "$ref": "https://jami.studio/schemas/registry/registry-ref.schema.json" },
+    "kind": {
+      "type": "string",
+      "enum": ["factory", "custom", "default"]
+    },
+    "state": {
+      "type": "string",
+      "enum": ["current", "deprecated", "missing_token", "invalid_alias", "contrast_failure", "migration_needed", "unsupported_family"]
+    }
+  }
+}

package/src/schemas/workbench-state.schema.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://jami.studio/schemas/registry/workbench-state.schema.json",
+  "title": "workbenchState",
+  "description": "Persisted shape of the Studio UI workbench overlay. This is the durable record written to localStorage today and to a hosted persistence backend when one is configured: an explicit schemaVersion, an optional persistence revision, and the saved theme draft. It is intentionally the saved slice only (not the live, unsaved draft or transient UI flags), so the same record validates whether it came from the browser, the in-memory adapter, or the operator-deferred hosted adapter.",
+  "type": "object",
+  "required": ["schemaVersion", "saved"],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": {
+      "const": "2026-06-23.workbench-state"
+    },
+    "revision": {
+      "description": "Opaque persistence revision the saved record resolved to. Null for a never-persisted local record; a string once an adapter has assigned a revision for optimistic-concurrency conflict detection.",
+      "type": ["string", "null"]
+    },
+    "saved": {
+      "$ref": "#/$defs/draft"
+    }
+  },
+  "$defs": {
+    "draft": {
+      "type": "object",
+      "required": ["target", "themeName", "presetName", "controls"],
+      "additionalProperties": false,
+      "properties": {
+        "target": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "themeName": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "presetName": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "controls": {
+          "$ref": "#/$defs/controls"
+        }
+      }
+    },
+    "controls": {
+      "type": "object",
+      "description": "Token-driven workbench control values. The eight factory controls are always present; brand options and imports may add further string controls. Property names are constrained to safe identifiers and values to strings so a persisted record can never carry an event handler, callback, or executable control.",
+      "required": ["accent", "focusRing", "radius", "spacing", "density", "motion", "dockWidth", "fontSize"],
+      "additionalProperties": {
+        "type": "string",
+        "maxLength": 2000
+      },
+      "propertyNames": {
+        "allOf": [
+          { "pattern": "^[a-zA-Z][a-zA-Z0-9_-]*$" },
+          { "not": { "enum": ["__proto__", "prototype", "constructor"] } }
+        ]
+      },
+      "properties": {
+        "accent": { "type": "string" },
+        "focusRing": { "type": "string" },
+        "radius": { "type": "string" },
+        "spacing": { "type": "string" },
+        "density": { "type": "string" },
+        "motion": { "type": "string" },
+        "dockWidth": { "type": "string" },
+        "fontSize": { "type": "string" }
+      }
+    }
+  }
+}

package/src/schemas/workspace-ref.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://jami.studio/schemas/registry/workspace-ref.schema.json",
+  "title": "workspaceRef",
+  "description": "Studio UI side of the workspace handshake. Identifies an installed workspace descriptor by registryRef and lists the registry items it installs. Mirrors the Jami Harness workspace-ref so both sides resolve the same registry identity.",
+  "type": "object",
+  "required": ["workspaceId", "registryRef", "installedItems"],
+  "additionalProperties": false,
+  "properties": {
+    "workspaceId": {
+      "type": "string",
+      "pattern": "^workspace_[a-z0-9][a-z0-9_-]*$"
+    },
+    "audience": {
+      "type": "string",
+      "enum": ["workspace", "docs", "operations", "governance", "custom"]
+    },
+    "registryRef": { "$ref": "https://jami.studio/schemas/registry/registry-ref.schema.json" },
+    "installedItems": {
+      "type": "array",
+      "items": { "$ref": "https://jami.studio/schemas/registry/registry-ref.schema.json" }
+    },
+    "registryState": {
+      "type": "string",
+      "enum": ["current", "missing_dependency", "unsupported_workspace_version", "stale_registry_item"]
+    }
+  }
+}