openuispec 0.2.14 → 0.2.16

package/schema/contract.schema.json

@@ -71,6 +71,11 @@
             "may_handle": {
               "type": "array",
               "items": { "type": "string" }
+            },
+            "must_avoid": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Anti-patterns for AI generators. Strings may start with [web], [ios], or [android] to scope to a platform. Unmarked items apply to all platforms."
             }
           },
           "additionalProperties": false
@@ -116,7 +121,12 @@
           "properties": {
             "must_handle": { "type": "array", "items": { "type": "string" } },
             "should_handle": { "type": "array", "items": { "type": "string" } },
-            "may_handle": { "type": "array", "items": { "type": "string" } }
+            "may_handle": { "type": "array", "items": { "type": "string" } },
+            "must_avoid": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Anti-patterns for AI generators. Strings may start with [web], [ios], or [android] to scope to a platform. Unmarked items apply to all platforms."
+            }
           },
           "additionalProperties": false
         }

package/schema/custom-contract.schema.json

@@ -112,6 +112,11 @@
               "type": "array",
               "items": { "type": "string" },
               "description": "Optional enhancements the generator MAY implement"
+            },
+            "must_avoid": {
+              "type": "array",
+              "items": { "type": "string" },
+              "description": "Anti-patterns for AI generators. Strings may start with [web], [ios], or [android] to scope to a platform. Unmarked items apply to all platforms."
             }
           },
           "additionalProperties": false

package/schema/openuispec.schema.json

@@ -259,6 +259,53 @@
         "type": "string"
       }
     },
+    "design": {
+      "type": "object",
+      "description": "Design intent and anti-patterns for this project",
+      "properties": {
+        "personality": { "type": "string", "description": "Brief description of the brand's visual personality" },
+        "complexity": {
+          "type": "string",
+          "enum": ["restrained", "balanced", "elaborate"],
+          "default": "balanced",
+          "description": "How elaborate animations, effects, and visual details should be"
+        },
+        "audience": { "type": "string", "description": "Who uses this app — informs tone and complexity" },
+        "avoid": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Project-specific anti-patterns. May use [web]/[ios]/[android] scope tags."
+        }
+      },
+      "additionalProperties": false
+    },
+    "generation_guidance": {
+      "type": "object",
+      "description": "Universal anti-patterns and audit config for AI generators",
+      "properties": {
+        "universal_anti_patterns": {
+          "type": "object",
+          "description": "Cross-contract anti-patterns by domain",
+          "properties": {
+            "typography": { "type": "array", "items": { "type": "string" } },
+            "color": { "type": "array", "items": { "type": "string" } },
+            "spacing": { "type": "array", "items": { "type": "string" } },
+            "motion": { "type": "array", "items": { "type": "string" } },
+            "elevation": { "type": "array", "items": { "type": "string" } },
+            "layout": { "type": "array", "items": { "type": "string" } },
+            "accessibility": { "type": "array", "items": { "type": "string" } }
+          },
+          "additionalProperties": false
+        },
+        "audit_threshold": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 100,
+          "description": "Minimum design quality score. Default 0 (informational). --min-score CLI flag takes precedence."
+        }
+      },
+      "additionalProperties": false
+    },
     "api": {
       "type": "object",
       "description": "API endpoint definitions",

package/schema/semantic-lint.ts

@@ -184,7 +184,8 @@ function collectIconRefs(filePath: string): { refs: Set<string>; suffixes: strin
   if (!isRecord(data) || !isRecord(data.icons)) return { refs, suffixes };
 
   const icons = data.icons as UnknownRecord;
-  const variantSuffixes = isRecord(icons.variants?.suffixes) ? icons.variants.suffixes : {};
+  const variants = isRecord(icons.variants) ? icons.variants : {};
+  const variantSuffixes = isRecord(variants.suffixes) ? variants.suffixes : {};
   for (const suffix of Object.keys(variantSuffixes)) {
     if (suffix.trim()) suffixes.push(suffix);
   }
@@ -217,8 +218,9 @@ function collectIconRefs(filePath: string): { refs: Set<string>; suffixes: strin
     }
   }
 
-  if (typeof icons.fallback?.missing_icon === "string") {
-    refs.add(icons.fallback.missing_icon);
+  const fallback = isRecord(icons.fallback) ? icons.fallback : {};
+  if (typeof fallback.missing_icon === "string") {
+    refs.add(fallback.missing_icon);
   }
 
   return { refs, suffixes };

package/schema/tokens/color.schema.json

@@ -75,6 +75,11 @@
         },
         "contrast_min": {
           "type": "number"
+        },
+        "generation_notes": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Sparse guidance for AI generators. Use [web]/[ios]/[android] tags for platform-specific notes."
         }
       },
       "required": [

package/schema/tokens/motion.schema.json

@@ -75,6 +75,11 @@
         "pattern": {
           "type": "string",
           "description": "Named animation pattern"
+        },
+        "generation_notes": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Sparse guidance for AI generators. Use [web]/[ios]/[android] tags for platform-specific notes."
         }
       },
       "additionalProperties": false

package/schema/tokens/typography.schema.json

@@ -60,6 +60,11 @@
             }
           },
           "additionalProperties": false
+        },
+        "generation_notes": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Sparse guidance for AI generators. Use [web]/[ios]/[android] tags for platform-specific notes."
         }
       },
       "required": [
@@ -93,6 +98,11 @@
             "capitalize",
             "none"
           ]
+        },
+        "generation_notes": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Sparse guidance for AI generators. Use [web]/[ios]/[android] tags for platform-specific notes."
         }
       },
       "required": [