@decantr/content 3.8.0

package/schemas/blueprint.v1.json

@@ -0,0 +1,225 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://decantr.ai/schemas/blueprint.v1.json",
+  "title": "Decantr Blueprint",
+  "type": "object",
+  "required": [
+    "$schema",
+    "id",
+    "version",
+    "name",
+    "theme",
+    "routes"
+  ],
+  "properties": {
+    "$schema": {
+      "const": "https://decantr.ai/schemas/blueprint.v1.json"
+    },
+    "id": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+    },
+    "version": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+    },
+    "decantr_compat": {
+      "type": "string"
+    },
+    "name": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+    },
+    "description": {
+      "type": "string"
+    },
+    "blueprint_portfolio": {
+      "type": "object",
+      "description": "Registry portfolio metadata for public blueprint discovery. This controls Featured/All/Labs presentation without changing direct slug availability.",
+      "required": [
+        "visibility",
+        "maturity",
+        "rationale",
+        "artifact"
+      ],
+      "properties": {
+        "visibility": {
+          "enum": [
+            "featured",
+            "public",
+            "labs",
+            "hidden"
+          ]
+        },
+        "maturity": {
+          "enum": [
+            "certified-flagship",
+            "supported-contract",
+            "experimental",
+            "fold-candidate",
+            "legacy-hidden"
+          ]
+        },
+        "rationale": {
+          "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+        },
+        "recommended_alternative": {
+          "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+        },
+        "artifact": {
+          "type": "object",
+          "required": [
+            "status"
+          ],
+          "properties": {
+            "status": {
+              "enum": [
+                "none",
+                "planned",
+                "candidate",
+                "certified"
+              ]
+            },
+            "showcase": {
+              "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+            },
+            "notes": {
+              "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "tags": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+    },
+    "archetype": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+    },
+    "compose": {
+      "type": "array",
+      "items": {
+        "anyOf": [
+          {
+            "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+          },
+          {
+            "type": "object",
+            "required": [
+              "archetype",
+              "prefix"
+            ],
+            "properties": {
+              "archetype": {
+                "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+              },
+              "prefix": {
+                "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+              },
+              "role": {
+                "enum": [
+                  "primary",
+                  "gateway",
+                  "public",
+                  "auxiliary"
+                ]
+              }
+            },
+            "additionalProperties": false
+          }
+        ]
+      }
+    },
+    "theme": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/themeRef"
+    },
+    "personality": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+        }
+      ]
+    },
+    "voice": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/voice"
+    },
+    "features": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+    },
+    "routes": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "shell": {
+            "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+          },
+          "archetype": {
+            "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+          },
+          "page": {
+            "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+          }
+        },
+        "additionalProperties": true
+      }
+    },
+    "overrides": {
+      "type": "object",
+      "properties": {
+        "features_add": {
+          "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+        },
+        "features_remove": {
+          "type": "array",
+          "items": {
+            "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+          }
+        },
+        "pages_remove": {
+          "type": "array",
+          "items": {
+            "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+          }
+        },
+        "pages": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "object",
+            "additionalProperties": true
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "seo_hints": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/seoHints"
+    },
+    "navigation": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/navigation"
+    },
+    "dependencies": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "string"
+        }
+      }
+    },
+    "suggested_themes": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+    },
+    "design_constraints": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "responsive_strategy": {
+      "type": "object",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/common.v1.json

@@ -0,0 +1,337 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://decantr.ai/schemas/common.v1.json",
+  "title": "Decantr Common Content Definitions",
+  "$defs": {
+    "nonEmptyString": {
+      "type": "string",
+      "minLength": 1
+    },
+    "nonEmptyStringArray": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/nonEmptyString"
+      }
+    },
+    "stringMap": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#/$defs/nonEmptyString"
+      }
+    },
+    "dependencyVersionMap": {
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#/$defs/nonEmptyString"
+      }
+    },
+    "patternRefObject": {
+      "type": "object",
+      "required": [
+        "pattern"
+      ],
+      "properties": {
+        "pattern": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "preset": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "as": {
+          "$ref": "#/$defs/nonEmptyString"
+        }
+      },
+      "additionalProperties": false
+    },
+    "patternReference": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        {
+          "$ref": "#/$defs/patternRefObject"
+        }
+      ]
+    },
+    "layoutGroup": {
+      "type": "object",
+      "required": [
+        "cols"
+      ],
+      "properties": {
+        "cols": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/patternReference"
+          }
+        },
+        "at": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "span": {
+          "type": "object",
+          "additionalProperties": {
+            "type": "number"
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "layoutItem": {
+      "anyOf": [
+        {
+          "$ref": "#/$defs/patternReference"
+        },
+        {
+          "$ref": "#/$defs/layoutGroup"
+        }
+      ]
+    },
+    "patternLayoutSpec": {
+      "type": "object",
+      "required": [
+        "layout",
+        "atoms"
+      ],
+      "properties": {
+        "layout": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "atoms": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "slots": {
+          "$ref": "#/$defs/stringMap"
+        }
+      },
+      "additionalProperties": true
+    },
+    "codeSpec": {
+      "type": "object",
+      "properties": {
+        "imports": {
+          "type": "string"
+        },
+        "example": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": true
+    },
+    "themeRef": {
+      "type": "object",
+      "required": [
+        "id"
+      ],
+      "properties": {
+        "id": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "mode": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "shape": {
+          "$ref": "#/$defs/nonEmptyString"
+        }
+      },
+      "additionalProperties": false
+    },
+    "suggestedTheme": {
+      "type": "object",
+      "properties": {
+        "ids": {
+          "$ref": "#/$defs/nonEmptyStringArray"
+        },
+        "modes": {
+          "$ref": "#/$defs/nonEmptyStringArray"
+        },
+        "shapes": {
+          "$ref": "#/$defs/nonEmptyStringArray"
+        }
+      },
+      "additionalProperties": false
+    },
+    "seoHints": {
+      "type": "object",
+      "properties": {
+        "schema_org": {
+          "$ref": "#/$defs/nonEmptyStringArray"
+        },
+        "meta_priorities": {
+          "$ref": "#/$defs/nonEmptyStringArray"
+        }
+      },
+      "additionalProperties": true
+    },
+    "navigationHotkey": {
+      "type": "object",
+      "required": [
+        "key"
+      ],
+      "properties": {
+        "key": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "route": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "action": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "label": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "semantics": {
+          "$ref": "#/$defs/hotkeySemantics"
+        }
+      },
+      "additionalProperties": false
+    },
+    "hotkeySemantics": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Behavioral directives for hotkey handlers. Declared once globally as navigation.hotkey_semantics OR per-hotkey on navigationHotkey.semantics (per-key wins).",
+      "properties": {
+        "chord_window_ms": {
+          "type": "integer",
+          "minimum": 100,
+          "maximum": 5000
+        },
+        "input_guard": {
+          "type": "boolean"
+        },
+        "modifier_suppression": {
+          "type": "boolean"
+        },
+        "match_case": {
+          "type": "boolean"
+        }
+      }
+    },
+    "commandPaletteContract": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Structured contract for the command palette. When present, LLMs should match exactly instead of improvising trigger/styling/commands.",
+      "properties": {
+        "trigger": {
+          "$ref": "#/$defs/nonEmptyString"
+        },
+        "placeholder": {
+          "type": "string"
+        },
+        "width": {
+          "type": "string"
+        },
+        "styling": {
+          "type": "string",
+          "enum": ["modal", "sheet", "inline", "fullscreen"]
+        },
+        "commands": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["id", "label"],
+            "additionalProperties": false,
+            "properties": {
+              "id": { "$ref": "#/$defs/nonEmptyString" },
+              "label": { "$ref": "#/$defs/nonEmptyString" },
+              "section": { "$ref": "#/$defs/nonEmptyString" },
+              "hotkey": { "$ref": "#/$defs/nonEmptyString" },
+              "action": { "$ref": "#/$defs/nonEmptyString" },
+              "route": { "$ref": "#/$defs/nonEmptyString" }
+            }
+          }
+        }
+      }
+    },
+    "navigation": {
+      "type": "object",
+      "properties": {
+        "command_palette": {
+          "oneOf": [
+            { "type": "boolean" },
+            { "$ref": "#/$defs/commandPaletteContract" }
+          ]
+        },
+        "hotkeys": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/navigationHotkey"
+          }
+        },
+        "hotkey_semantics": {
+          "$ref": "#/$defs/hotkeySemantics"
+        }
+      },
+      "additionalProperties": true
+    },
+    "voice": {
+      "type": "object",
+      "properties": {
+        "tone": {
+          "type": "string"
+        },
+        "cta_verbs": {
+          "$ref": "#/$defs/nonEmptyStringArray"
+        },
+        "avoid": {
+          "$ref": "#/$defs/nonEmptyStringArray"
+        },
+        "empty_states": {
+          "type": "string"
+        },
+        "errors": {
+          "type": "string"
+        },
+        "loading": {
+          "type": "string"
+        },
+        "metrics_format": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": true
+    },
+    "classification": {
+      "type": "object",
+      "properties": {
+        "triggers": {
+          "type": "object",
+          "properties": {
+            "primary": {
+              "$ref": "#/$defs/nonEmptyStringArray"
+            },
+            "secondary": {
+              "$ref": "#/$defs/nonEmptyStringArray"
+            },
+            "negative": {
+              "$ref": "#/$defs/nonEmptyStringArray"
+            }
+          },
+          "required": [
+            "primary",
+            "secondary",
+            "negative"
+          ],
+          "additionalProperties": false
+        },
+        "implies": {
+          "$ref": "#/$defs/nonEmptyStringArray"
+        },
+        "weight": {
+          "type": "number"
+        },
+        "tier": {
+          "$ref": "#/$defs/nonEmptyString"
+        }
+      },
+      "required": [
+        "triggers",
+        "implies",
+        "weight",
+        "tier"
+      ],
+      "additionalProperties": true
+    }
+  }
+}