openuispec 0.2.1 → 0.2.3

package/README.md

@@ -244,6 +244,21 @@ Validate with: `openuispec validate`
 
 Use `openuispec validate semantic` to run cross-reference linting for locale keys, formatter refs, mapper refs, contracts, icons, navigation targets, and API endpoint references.
 
+### Shared interactive state roles
+
+Interactive contracts may optionally express state-specific visual roles inside their token maps with a nested `states:` object. This lets generators use explicit foreground/background/icon/border roles for `default`, `active`, `selected`, `pressed`, `focused`, `disabled`, `loading`, and `error` states instead of inferring them from container colors or platform defaults.
+
+Allowed visual role keys (no others are permitted):
+
+- `background`
+- `text`
+- `icon`
+- `border`
+- `badge_background`
+- `badge_text`
+
+When `states:` is omitted, generators fall back to the token values defined at that level plus the base contract semantics.
+
 ## Output directories
 
 By default, drift stores state in `generated/<target>/<project>/`. To point targets to your actual code directories, add `output_dir` to `openuispec.yaml`:

package/examples/social-app/AGENTS.md

@@ -1,5 +1,5 @@
 <!-- openuispec-rules-start -->
-<!-- openuispec-rules-version: 0.1.47 -->
+<!-- openuispec-rules-version: 0.2.2 -->
 # OpenUISpec — AI Assistant Rules
 # ================================
 # This project uses OpenUISpec to define UI as a semantic spec.

package/examples/social-app/CLAUDE.md

@@ -1,5 +1,5 @@
 <!-- openuispec-rules-start -->
-<!-- openuispec-rules-version: 0.1.47 -->
+<!-- openuispec-rules-version: 0.2.2 -->
 # OpenUISpec — AI Assistant Rules
 # ================================
 # This project uses OpenUISpec to define UI as a semantic spec.

package/examples/social-app/generated/web/social-app/src/components/Shell.tsx

@@ -91,23 +91,11 @@ export function AppShell() {
 
         {sizeClass !== "expanded" ? <BottomTabBar unreadCount={unreadCount} /> : null}
 
-        {location.pathname.startsWith("/home") || location.pathname === "/" ? (
-          <Link
-            to="/create"
-            className={cn(
-              "interactive-press fixed z-30 flex h-14 w-14 items-center justify-center rounded-cap-primary bg-[var(--color-brand-primary)] text-white shadow-md",
-              sizeClass === "expanded" ? "bottom-8 right-8" : "bottom-20 right-4",
-            )}
-            aria-label={t("nav.create")}
-          >
-            <Icon name="create_post" className="h-6 w-6" />
-          </Link>
-        ) : null}
       </div>
 
       {toast ? (
         <div className="pointer-events-none fixed inset-x-0 top-4 z-50 flex justify-center px-4">
-          <div className="rounded-cap-primary bg-[var(--color-brand-primary)] px-5 py-3 text-sm font-medium text-white shadow-md">
+          <div className="rounded-cap-primary bg-[var(--color-brand-primary)] px-5 py-3 text-sm font-medium text-[var(--color-brand-primary-on)] shadow-md">
             {toast.message}
           </div>
         </div>
@@ -160,7 +148,7 @@ function BottomTabBar({ unreadCount }: { unreadCount: number }) {
             <Icon name={route.icon} className="h-5 w-5" />
             <span>{t(route.labelKey)}</span>
             {route.to === "/notifications" && unreadCount > 0 ? (
-              <span className="absolute right-3 top-2 inline-flex min-h-5 min-w-5 items-center justify-center rounded-full bg-[var(--color-brand-accent)] px-1.5 text-[10px] font-semibold text-white">
+              <span className="absolute right-3 top-2 inline-flex min-h-5 min-w-5 items-center justify-center rounded-full bg-[var(--color-brand-accent)] px-1.5 text-[10px] font-semibold text-[var(--color-brand-accent-on)]">
                 {unreadCount}
               </span>
             ) : null}
@@ -187,20 +175,32 @@ function DesktopSidebar({ unreadCount }: { unreadCount: number }) {
             to={route.to}
             className={({ isActive }) =>
               cn(
-                "relative flex items-center gap-3 rounded-cap-primary px-4 py-3 text-sm font-semibold transition",
+                "relative rounded-cap-primary px-4 py-3 text-sm font-semibold transition",
                 isActive
-                  ? "bg-[var(--color-brand-primary)] text-white shadow-sm"
-                  : "text-[var(--color-text-secondary)] hover:bg-[var(--color-surface-tertiary)]",
+                  ? "bg-[var(--color-brand-primary)] shadow-sm"
+                  : "hover:bg-[var(--color-surface-tertiary)]",
               )
             }
           >
-            <Icon name={route.icon} className="h-5 w-5" />
-            <span>{t(route.labelKey)}</span>
-            {route.to === "/notifications" && unreadCount > 0 ? (
-              <span className="ml-auto rounded-full bg-[var(--color-brand-accent)] px-2 py-1 text-[10px] font-semibold text-white">
-                {unreadCount}
-              </span>
-            ) : null}
+            {({ isActive }) => (
+              <div className="flex items-center gap-3">
+                <Icon
+                  name={route.icon}
+                  className={cn(
+                    "h-5 w-5 shrink-0",
+                    isActive ? "text-[var(--color-brand-primary-on)]" : "text-[var(--color-text-secondary)]",
+                  )}
+                />
+                <span className={cn(isActive ? "text-[var(--color-brand-primary-on)]" : "text-[var(--color-text-secondary)]")}>
+                  {t(route.labelKey)}
+                </span>
+                {route.to === "/notifications" && unreadCount > 0 ? (
+                  <span className="ml-auto rounded-full bg-[var(--color-brand-accent)] px-2 py-1 text-[10px] font-semibold text-[var(--color-brand-accent-on)]">
+                    {unreadCount}
+                  </span>
+                ) : null}
+              </div>
+            )}
           </NavLink>
         ))}
       </nav>

package/examples/social-app/generated/web/social-app/src/components/ui.tsx

@@ -73,7 +73,7 @@ export function ActionButton({
       : variant === "secondary"
         ? "rounded-cap-alternate border-[var(--color-border-strong)] bg-transparent text-[var(--color-text-primary)]"
         : variant === "destructive"
-          ? "rounded-cap-primary border-transparent bg-[var(--color-semantic-danger)] text-white"
+          ? "rounded-cap-primary border-transparent bg-[var(--color-semantic-danger)] text-[var(--color-semantic-danger-on)]"
           : variant === "fab"
             ? "rounded-cap-primary border-transparent bg-[var(--color-brand-primary)] text-[var(--color-brand-primary-on)] shadow-md"
           : selected

package/examples/social-app/generated/web/social-app/src/styles.css

@@ -16,6 +16,7 @@
   --color-border-default: #e0dcd6;
   --color-border-strong: #c5c0b8;
   --color-semantic-danger: #d43b3b;
+  --color-semantic-danger-on: #ffffff;
   color-scheme: light;
 }
 

package/examples/social-app/openuispec/contracts/action_trigger.yaml

@@ -15,6 +15,10 @@ action_trigger:
         text: "color.brand.primary.on_color"
         border_width: 0
         shape: "2px 24px 2px 24px"
+        states:
+          disabled:
+            background: "color.surface.tertiary"
+            text: "color.text.tertiary"
       platform_mapping:
         ios: { shape: "RoundedCapShape(diagonal: .primary)" }
         android: { shape: "RoundedCapShape(diagonal = Primary)" }
@@ -36,6 +40,10 @@ action_trigger:
         text: "color.text.primary"
         border: { color: "color.border.strong", width: 1 }
         shape: "24px 2px 24px 2px"
+        states:
+          disabled:
+            text: "color.text.tertiary"
+            border: { color: "color.border.default", width: 1 }
       platform_mapping:
         ios: { shape: "RoundedCapShape(diagonal: .alternate)" }
         android: { shape: "RoundedCapShape(diagonal = Alternate)" }
@@ -56,6 +64,15 @@ action_trigger:
         text_selected: "color.brand.accent.on_color"
         border: { color: "color.border.default", width: 1 }
         shape: "2px 24px 2px 24px"
+        states:
+          default:
+            background: "transparent"
+            text: "color.text.primary"
+            border: { color: "color.border.default", width: 1 }
+          selected:
+            background: "color.brand.accent"
+            text: "color.brand.accent.on_color"
+            border: { color: "color.brand.accent", width: 1 }
       platform_mapping:
         ios: { shape: "RoundedCapShape(diagonal: .primary)" }
         android: { shape: "RoundedCapShape(diagonal = Primary)" }
@@ -71,6 +88,10 @@ action_trigger:
         background: "color.semantic.danger"
         text: "color.semantic.danger.on_color"
         shape: "2px 24px 2px 24px"
+        states:
+          disabled:
+            background: "color.surface.tertiary"
+            text: "color.text.tertiary"
       platform_mapping:
         ios: { shape: "RoundedCapShape(diagonal: .primary)", role: "destructive" }
         android: { shape: "RoundedCapShape(diagonal = Primary)" }

package/examples/social-app/openuispec/contracts/nav_container.yaml

@@ -9,6 +9,16 @@ nav_container:
         background: "color.surface.primary"
         tint_active: "color.brand.primary"
         tint_inactive: "color.text.tertiary"
+        item:
+          states:
+            default:
+              text: "color.text.tertiary"
+              icon: "color.text.tertiary"
+            active:
+              text: "color.brand.primary"
+              icon: "color.brand.primary"
+              badge_background: "color.brand.accent"
+              badge_text: "color.brand.accent.on_color"
       platform_mapping:
         ios: { uses_system_tab_bar: true, height: 49 }
         android: { component: "NavigationBar" }
@@ -23,6 +33,17 @@ nav_container:
       tokens:
         background: "color.surface.secondary"
         width: 280
+        item:
+          states:
+            default:
+              text: "color.text.secondary"
+              icon: "color.text.secondary"
+            active:
+              background: "color.brand.primary"
+              text: "color.brand.primary.on_color"
+              icon: "color.brand.primary.on_color"
+              badge_background: "color.brand.accent"
+              badge_text: "color.brand.accent.on_color"
       platform_mapping:
         ios: { style: "sidebar" }
         android: { component: "NavigationRail" }

package/examples/todo-orbit/openuispec/contracts/action_trigger.yaml

@@ -5,11 +5,21 @@ action_trigger:
       text: "color.brand.primary.on_color"
       border: { width: 2, color: "color.brand.primary" }
       cut_size: "spacing.sm"
+      states:
+        disabled:
+          background: "color.surface.secondary"
+          text: "color.text.tertiary"
+          border: { width: 2, color: "color.border.default" }
     ghost:
       background: "color.surface.secondary"
       text: "color.text.primary"
       border: { width: 2, color: "color.brand.primary" }
       cut_size: "spacing.sm"
+      states:
+        disabled:
+          background: "color.surface.secondary"
+          text: "color.text.tertiary"
+          border: { width: 2, color: "color.border.default" }
   platform_mapping:
     ios:
       primary: { shape: "CutCornerShape", clip: true, style: ".plain" }

package/examples/todo-orbit/openuispec/contracts/nav_container.yaml

@@ -6,24 +6,44 @@ nav_container:
       border_top: { width: 1, color: "color.border.default" }
       icon_size: 22
       label_style: "typography.caption"
-      active_color: "color.brand.primary"
-      inactive_color: "color.text.tertiary"
+      item:
+        states:
+          default:
+            text: "color.text.tertiary"
+            icon: "color.text.tertiary"
+          active:
+            text: "color.brand.primary"
+            icon: "color.brand.primary"
     rail:
       width: 76
       background: "color.surface.secondary"
       icon_size: 22
       label_style: "typography.caption"
-      active_color: "color.brand.primary"
+      item:
+        states:
+          default:
+            text: "color.text.secondary"
+            icon: "color.text.secondary"
+          active:
+            text: "color.brand.primary"
+            icon: "color.brand.primary"
     sidebar:
       width: { collapsed: 72, expanded: 240 }
       background: "color.surface.secondary"
       item_height: 48
       item_radius: "spacing.sm"
       item_padding_h: "spacing.md"
-      active_background: "color.brand.primary"
-      active_text: "color.brand.primary.on_color"
       icon_size: 20
       label_style: "typography.body_sm"
+      item:
+        states:
+          default:
+            text: "color.text.secondary"
+            icon: "color.text.secondary"
+          active:
+            background: "color.brand.primary"
+            text: "color.brand.primary.on_color"
+            icon: "color.brand.primary.on_color"
   platform_mapping:
     ios:
       tab_bar: { widget: "TabView" }

package/mcp-server/index.ts

@@ -65,6 +65,39 @@ function toolError(err: unknown): { content: [{ type: "text"; text: string }]; i
   return { content: [{ type: "text" as const, text: `Error: ${formatError(err)}` }], isError: true };
 }
 
+function formatAuditValue(value: unknown): string {
+  if (typeof value === "string") return value;
+  return JSON.stringify(value);
+}
+
+function collectStateRoleAuditItems(node: unknown, prefix = ""): string[] {
+  if (!node || typeof node !== "object" || Array.isArray(node)) {
+    return [];
+  }
+
+  const items: string[] = [];
+  const record = node as Record<string, unknown>;
+
+  const states = record.states;
+  if (states && typeof states === "object" && !Array.isArray(states)) {
+    for (const [stateName, roles] of Object.entries(states as Record<string, unknown>)) {
+      if (!roles || typeof roles !== "object" || Array.isArray(roles)) continue;
+      for (const [roleName, roleValue] of Object.entries(roles as Record<string, unknown>)) {
+        const statePath = prefix ? `${prefix}.states.${stateName}.${roleName}` : `states.${stateName}.${roleName}`;
+        items.push(`${statePath} = ${formatAuditValue(roleValue)}`);
+      }
+    }
+  }
+
+  for (const [key, value] of Object.entries(record)) {
+    if (key === "states" || !value || typeof value !== "object" || Array.isArray(value)) continue;
+    const childPrefix = prefix ? `${prefix}.${key}` : key;
+    items.push(...collectStateRoleAuditItems(value, childPrefix));
+  }
+
+  return items;
+}
+
 // ── create server ────────────────────────────────────────────────────
 
 export const server = new McpServer(
@@ -173,6 +206,17 @@ function buildAuditChecklist(projectDir: string, target: string, screenFilter?:
               lines.push(`- [ ] ${item}`);
             }
           }
+
+          const stateRoleItems = collectStateRoleAuditItems(variant?.tokens);
+          if (stateRoleItems.length) {
+            if (!mustHandle?.length) {
+              lines.push(`\n### ${contractName}.${variantName}`);
+            }
+            lines.push(`- [ ] Explicit state-role tokens are implemented for ${contractName}.${variantName}`);
+            for (const item of stateRoleItems) {
+              lines.push(`- [ ] ${item}`);
+            }
+          }
         }
 
         // Top-level generation.must_handle
@@ -183,6 +227,14 @@ function buildAuditChecklist(projectDir: string, target: string, screenFilter?:
             lines.push(`- [ ] ${item}`);
           }
         }
+
+        const topLevelStateRoleItems = collectStateRoleAuditItems(contract?.tokens);
+        if (topLevelStateRoleItems.length) {
+          lines.push(`\n### ${contractName} (state-role tokens)`);
+          for (const item of topLevelStateRoleItems) {
+            lines.push(`- [ ] ${item}`);
+          }
+        }
       } catch { /* skip unparseable files */ }
     }
     lines.push("");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openuispec",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "license": "MIT",
   "type": "module",
   "description": "A semantic UI specification format for AI-native, platform-native app development",

package/schema/contract.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://openuispec.org/schema/contract.schema.json",
+  "$id": "https://openuispec.rsteam.uz/schema/contract.schema.json",
   "title": "OpenUISpec Standard Contract Extension",
   "description": "Extension file for a standard contract — add variants, override tokens, platform mapping, and generation hints",
   "type": "object",
@@ -36,13 +36,12 @@
           "type": "object",
           "description": "Additional props beyond the spec definition",
           "additionalProperties": {
-            "$ref": "https://openuispec.org/schema/custom-contract.schema.json#/$defs/prop_def"
+            "$ref": "https://openuispec.rsteam.uz/schema/custom-contract.schema.json#/$defs/prop_def"
           }
         },
         "tokens": {
-          "type": "object",
           "description": "Token overrides at the contract level",
-          "additionalProperties": true
+          "$ref": "#/$defs/token_object"
         },
         "platform_mapping": {
           "type": "object",
@@ -80,7 +79,7 @@
           "type": "array",
           "description": "Additional behavioral test cases",
           "items": {
-            "$ref": "https://openuispec.org/schema/custom-contract.schema.json#/$defs/test_case"
+            "$ref": "https://openuispec.rsteam.uz/schema/custom-contract.schema.json#/$defs/test_case"
           }
         }
       },
@@ -95,9 +94,8 @@
           "description": "Human-readable description of this variant"
         },
         "tokens": {
-          "type": "object",
           "description": "Visual token bindings for this variant",
-          "additionalProperties": true
+          "$ref": "#/$defs/token_object"
         },
         "platform_mapping": {
           "type": "object",
@@ -124,6 +122,58 @@
         }
       },
       "additionalProperties": false
+    },
+    "token_object": {
+      "type": "object",
+      "description": "Recursive token object. If a `states` key is present, it must use the documented interactive state-role shape.",
+      "properties": {
+        "states": {
+          "$ref": "#/$defs/state_role_map"
+        }
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/token_value"
+      }
+    },
+    "token_value": {
+      "description": "Any token value, including nested token objects and arrays.",
+      "oneOf": [
+        {
+          "type": ["string", "number", "boolean", "null"]
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/token_value"
+          }
+        },
+        {
+          "$ref": "#/$defs/token_object"
+        }
+      ]
+    },
+    "state_role_map": {
+      "type": "object",
+      "description": "Map of state names to visual-role overrides.",
+      "propertyNames": {
+        "pattern": "^[a-z][a-z0-9_]*$"
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/state_visual_roles"
+      }
+    },
+    "state_visual_roles": {
+      "type": "object",
+      "description": "Visual-role overrides available inside token `states` maps.",
+      "properties": {
+        "background": { "$ref": "#/$defs/token_value" },
+        "text": { "$ref": "#/$defs/token_value" },
+        "icon": { "$ref": "#/$defs/token_value" },
+        "border": { "$ref": "#/$defs/token_value" },
+        "badge_background": { "$ref": "#/$defs/token_value" },
+        "badge_text": { "$ref": "#/$defs/token_value" }
+      },
+      "additionalProperties": false
     }
   }
 }

package/schema/custom-contract.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://openuispec.org/schema/custom-contract.schema.json",
+  "$id": "https://openuispec.rsteam.uz/schema/custom-contract.schema.json",
   "title": "OpenUISpec Custom Contract",
   "description": "Custom contract extension — root key must be x_ prefixed, value follows the standard contract anatomy",
   "type": "object",
@@ -10,7 +10,7 @@
     "pattern": "^x_[a-z][a-z0-9_]*$"
   },
   "additionalProperties": {
-    "$ref": "https://openuispec.org/schema/custom-contract.schema.json#/$defs/contract_def"
+    "$ref": "https://openuispec.rsteam.uz/schema/custom-contract.schema.json#/$defs/contract_def"
   },
   "$defs": {
     "contract_def": {
@@ -25,14 +25,14 @@
           "type": "object",
           "description": "Typed property definitions for this contract",
           "additionalProperties": {
-            "$ref": "https://openuispec.org/schema/custom-contract.schema.json#/$defs/prop_def"
+            "$ref": "https://openuispec.rsteam.uz/schema/custom-contract.schema.json#/$defs/prop_def"
           }
         },
         "states": {
           "type": "object",
           "description": "State machine definition — each key is a state name",
           "additionalProperties": {
-            "$ref": "https://openuispec.org/schema/custom-contract.schema.json#/$defs/state_def"
+            "$ref": "https://openuispec.rsteam.uz/schema/custom-contract.schema.json#/$defs/state_def"
           }
         },
         "a11y": {
@@ -62,9 +62,8 @@
           "additionalProperties": true
         },
         "tokens": {
-          "type": "object",
           "description": "Per-variant visual token bindings",
-          "additionalProperties": true
+          "$ref": "https://openuispec.rsteam.uz/schema/custom-contract.schema.json#/$defs/token_object"
         },
         "platform_mapping": {
           "type": "object",
@@ -92,7 +91,7 @@
           "type": "object",
           "description": "Per-platform library/framework requirements",
           "additionalProperties": {
-            "$ref": "https://openuispec.org/schema/custom-contract.schema.json#/$defs/dependency_def"
+            "$ref": "https://openuispec.rsteam.uz/schema/custom-contract.schema.json#/$defs/dependency_def"
           }
         },
         "generation": {
@@ -121,7 +120,7 @@
           "type": "array",
           "description": "Behavioral verification scenarios",
           "items": {
-            "$ref": "https://openuispec.org/schema/custom-contract.schema.json#/$defs/test_case"
+            "$ref": "https://openuispec.rsteam.uz/schema/custom-contract.schema.json#/$defs/test_case"
           }
         }
       },
@@ -208,6 +207,58 @@
       },
       "additionalProperties": false
     },
+    "token_object": {
+      "type": "object",
+      "description": "Recursive token object. If a `states` key is present, it must use the documented interactive state-role shape.",
+      "properties": {
+        "states": {
+          "$ref": "https://openuispec.rsteam.uz/schema/custom-contract.schema.json#/$defs/state_role_map"
+        }
+      },
+      "additionalProperties": {
+        "$ref": "https://openuispec.rsteam.uz/schema/custom-contract.schema.json#/$defs/token_value"
+      }
+    },
+    "token_value": {
+      "description": "Any token value, including nested token objects and arrays.",
+      "oneOf": [
+        {
+          "type": ["string", "number", "boolean", "null"]
+        },
+        {
+          "type": "array",
+          "items": {
+            "$ref": "https://openuispec.rsteam.uz/schema/custom-contract.schema.json#/$defs/token_value"
+          }
+        },
+        {
+          "$ref": "https://openuispec.rsteam.uz/schema/custom-contract.schema.json#/$defs/token_object"
+        }
+      ]
+    },
+    "state_role_map": {
+      "type": "object",
+      "description": "Map of state names to visual-role overrides.",
+      "propertyNames": {
+        "pattern": "^[a-z][a-z0-9_]*$"
+      },
+      "additionalProperties": {
+        "$ref": "https://openuispec.rsteam.uz/schema/custom-contract.schema.json#/$defs/state_visual_roles"
+      }
+    },
+    "state_visual_roles": {
+      "type": "object",
+      "description": "Visual-role overrides available inside token `states` maps.",
+      "properties": {
+        "background": { "$ref": "https://openuispec.rsteam.uz/schema/custom-contract.schema.json#/$defs/token_value" },
+        "text": { "$ref": "https://openuispec.rsteam.uz/schema/custom-contract.schema.json#/$defs/token_value" },
+        "icon": { "$ref": "https://openuispec.rsteam.uz/schema/custom-contract.schema.json#/$defs/token_value" },
+        "border": { "$ref": "https://openuispec.rsteam.uz/schema/custom-contract.schema.json#/$defs/token_value" },
+        "badge_background": { "$ref": "https://openuispec.rsteam.uz/schema/custom-contract.schema.json#/$defs/token_value" },
+        "badge_text": { "$ref": "https://openuispec.rsteam.uz/schema/custom-contract.schema.json#/$defs/token_value" }
+      },
+      "additionalProperties": false
+    },
     "dependency_def": {
       "type": "object",
       "description": "Platform-specific dependencies",

package/schema/defs/action.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://openuispec.org/schema/defs/action.schema.json",
+  "$id": "https://openuispec.rsteam.uz/schema/defs/action.schema.json",
   "title": "OpenUISpec Action",
   "description": "Discriminated union of the 14 action types in OpenUISpec",
 

package/schema/defs/adaptive.schema.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://openuispec.org/schema/defs/adaptive.schema.json",
+  "$id": "https://openuispec.rsteam.uz/schema/defs/adaptive.schema.json",
   "title": "OpenUISpec Adaptive Override",
   "description": "Adaptive overrides keyed by size class (compact, regular, expanded). Values are override objects whose shape depends on context.",
   "type": "object",