@decantr/content 3.8.0

package/schemas/search-response.v1.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://decantr.ai/schemas/search-response.v1.json",
+  "title": "Decantr Public Search Response",
+  "type": "object",
+  "required": [
+    "results",
+    "total"
+  ],
+  "properties": {
+    "results": {
+      "type": "array",
+      "items": {
+        "$ref": "https://decantr.ai/schemas/public-content-summary.v1.json"
+      }
+    },
+    "total": {
+      "type": "number"
+    },
+    "limit": {
+      "type": "number"
+    },
+    "offset": {
+      "type": "number"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/section-pack.v1.json

@@ -0,0 +1,128 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://decantr.ai/schemas/section-pack.v1.json",
+  "title": "Decantr Section Execution Pack",
+  "type": "object",
+  "required": ["$schema", "packVersion", "packType", "objective", "target", "preset", "scope", "requiredSetup", "allowedVocabulary", "examples", "antiPatterns", "successChecks", "tokenBudget", "data", "renderedMarkdown"],
+  "properties": {
+    "$schema": {
+      "const": "https://decantr.ai/schemas/section-pack.v1.json"
+    },
+    "packVersion": {
+      "const": "1.0.0"
+    },
+    "packType": {
+      "const": "section"
+    },
+    "objective": {
+      "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/nonEmptyString"
+    },
+    "target": {
+      "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/executionPackTarget"
+    },
+    "preset": {
+      "type": ["string", "null"]
+    },
+    "scope": {
+      "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/executionPackScope"
+    },
+    "requiredSetup": {
+      "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/stringArray"
+    },
+    "allowedVocabulary": {
+      "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/stringArray"
+    },
+    "examples": {
+      "type": "array",
+      "items": {
+        "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/executionPackExample"
+      }
+    },
+    "antiPatterns": {
+      "type": "array",
+      "items": {
+        "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/executionPackAntiPattern"
+      }
+    },
+    "successChecks": {
+      "type": "array",
+      "items": {
+        "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/executionPackSuccessCheck"
+      }
+    },
+    "tokenBudget": {
+      "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/executionPackTokenBudget"
+    },
+    "data": {
+      "type": "object",
+      "required": ["sectionId", "role", "shell", "description", "features", "theme", "routes"],
+      "properties": {
+        "sectionId": {
+          "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/nonEmptyString"
+        },
+        "role": {
+          "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/nonEmptyString"
+        },
+        "shell": {
+          "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/nonEmptyString"
+        },
+        "description": {
+          "type": "string"
+        },
+        "features": {
+          "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/stringArray"
+        },
+        "theme": {
+          "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/themeRef"
+        },
+        "routes": {
+          "type": "array",
+          "items": {
+            "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/routeSummary"
+          }
+        },
+        "navigationItems": {
+          "type": "array",
+          "description": "Items rendered in the shell's primary navigation for this section.",
+          "items": {
+            "type": "object",
+            "required": ["label", "route"],
+            "additionalProperties": false,
+            "properties": {
+              "label": { "type": "string", "minLength": 1 },
+              "route": { "type": "string", "minLength": 1 },
+              "icon": { "type": "string", "minLength": 1 },
+              "hotkey": { "type": "string", "minLength": 1 },
+              "active_match": { "type": "string", "minLength": 1 },
+              "badge": { "type": "string", "minLength": 1 }
+            }
+          }
+        },
+        "directives": {
+          "type": "array",
+          "description": "Execution-level directives emitted into section-pack rendering.",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "themeDecorators": {
+          "type": "array",
+          "description": "Required theme decorator contract — class + intent + slot hint, surfaced as a hard table in the rendered pack so cold-LLM scaffolds apply them rather than treating the decorator list as advisory.",
+          "items": {
+            "type": "object",
+            "required": ["class", "intent", "applyTo"],
+            "additionalProperties": false,
+            "properties": {
+              "class": { "type": "string", "minLength": 1 },
+              "intent": { "type": "string" },
+              "applyTo": { "type": "string" }
+            }
+          }
+        }
+      },
+      "additionalProperties": false
+    },
+    "renderedMarkdown": {
+      "$ref": "https://decantr.ai/schemas/execution-pack.common.v1.json#/$defs/nonEmptyString"
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/shell.v1.json

@@ -0,0 +1,69 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://decantr.ai/schemas/shell.v1.json",
+  "title": "Decantr Shell",
+  "type": "object",
+  "required": [
+    "$schema",
+    "id",
+    "name"
+  ],
+  "properties": {
+    "$schema": {
+      "const": "https://decantr.ai/schemas/shell.v1.json"
+    },
+    "id": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+    },
+    "name": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+    },
+    "description": {
+      "type": "string"
+    },
+    "root": {
+      "type": "string"
+    },
+    "nav": {
+      "type": "string"
+    },
+    "header": {
+      "type": "string"
+    },
+    "nav_style": {
+      "type": "string"
+    },
+    "dimensions": {
+      "type": [
+        "object",
+        "null"
+      ],
+      "additionalProperties": true
+    },
+    "layout": {
+      "type": "string"
+    },
+    "atoms": {
+      "type": "string"
+    },
+    "config": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "configurable": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "guidance": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/stringMap"
+    },
+    "internal_layout": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "code": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/codeSpec"
+    }
+  },
+  "additionalProperties": true
+}

package/schemas/showcase-manifest-entry.v1.json

@@ -0,0 +1,92 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://decantr.ai/schemas/showcase-manifest-entry.v1.json",
+  "title": "Decantr Showcase Manifest Entry",
+  "type": "object",
+  "required": [
+    "slug",
+    "status",
+    "classification"
+  ],
+  "properties": {
+    "slug": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+    },
+    "status": {
+      "type": "string"
+    },
+    "classification": {
+      "type": "string"
+    },
+    "origin": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "target": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "goldenCandidate": {
+      "type": [
+        "string",
+        "boolean"
+      ]
+    },
+    "notes": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "thumbnail": {
+      "anyOf": [
+        {
+          "type": "object",
+          "required": [
+            "src",
+            "alt"
+          ],
+          "properties": {
+            "src": {
+              "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+            },
+            "alt": {
+              "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+            },
+            "width": {
+              "type": "number"
+            },
+            "height": {
+              "type": "number"
+            }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "url": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "verification": {
+      "anyOf": [
+        {
+          "$ref": "https://decantr.ai/schemas/showcase-shortlist-report.v1.json#/$defs/showcaseShortlistEntry"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/showcase-manifest.v1.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://decantr.ai/schemas/showcase-manifest.v1.json",
+  "title": "Decantr Showcase Manifest Response",
+  "type": "object",
+  "required": [
+    "total",
+    "shortlisted",
+    "apps"
+  ],
+  "properties": {
+    "total": {
+      "type": "number",
+      "minimum": 0
+    },
+    "shortlisted": {
+      "type": "number",
+      "minimum": 0
+    },
+    "apps": {
+      "type": "array",
+      "items": {
+        "$ref": "https://decantr.ai/schemas/showcase-manifest-entry.v1.json"
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/showcase-shortlist.v1.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://decantr.ai/schemas/showcase-shortlist.v1.json",
+  "title": "Decantr Showcase Shortlist Response",
+  "type": "object",
+  "required": [
+    "generatedAt",
+    "summary",
+    "apps"
+  ],
+  "properties": {
+    "generatedAt": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "summary": {
+      "anyOf": [
+        {
+          "$ref": "https://decantr.ai/schemas/showcase-shortlist-report.v1.json#/properties/summary"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "apps": {
+      "type": "array",
+      "items": {
+        "$ref": "https://decantr.ai/schemas/showcase-manifest-entry.v1.json"
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/schemas/theme.v1.json

@@ -0,0 +1,190 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://decantr.ai/schemas/theme.v1.json",
+  "title": "Decantr Theme",
+  "type": "object",
+  "required": [
+    "$schema",
+    "id",
+    "name",
+    "description"
+  ],
+  "properties": {
+    "$schema": {
+      "const": "https://decantr.ai/schemas/theme.v1.json"
+    },
+    "id": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+    },
+    "name": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+    },
+    "description": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyString"
+    },
+    "tags": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+    },
+    "personality": {
+      "type": "string"
+    },
+    "seed": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/stringMap"
+    },
+    "palette": {
+      "type": "object",
+      "additionalProperties": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            }
+          }
+        ]
+      }
+    },
+    "modes": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+    },
+    "shapes": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+    },
+    "decantr_compat": {
+      "type": "string"
+    },
+    "source": {
+      "type": "string"
+    },
+    "decorators": {
+      "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/stringMap"
+    },
+    "treatments": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "string"
+        }
+      }
+    },
+    "spatial": {
+      "type": "object",
+      "properties": {
+        "density_bias": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "content_gap_shift": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "section_padding": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "card_wrapping": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "surface_override": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "additionalProperties": true
+    },
+    "motion": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "effects": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "compositions": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": true
+      }
+    },
+    "radius": {
+      "type": "object",
+      "properties": {
+        "philosophy": {
+          "type": "string"
+        },
+        "base": {
+          "type": "number"
+        }
+      },
+      "additionalProperties": true
+    },
+    "pattern_preferences": {
+      "type": "object",
+      "properties": {
+        "prefer": {
+          "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+        },
+        "avoid": {
+          "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+        },
+        "default_presets": {
+          "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/stringMap"
+        }
+      },
+      "additionalProperties": true
+    },
+    "shell": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "typography": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "tokens": {
+      "type": "object",
+      "additionalProperties": true
+    },
+    "decorator_definitions": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "properties": {
+          "description": {
+            "type": "string"
+          },
+          "intent": {
+            "type": "string"
+          },
+          "suggested_properties": {
+            "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/stringMap"
+          },
+          "pairs_with": {
+            "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+          },
+          "usage": {
+            "$ref": "https://decantr.ai/schemas/common.v1.json#/$defs/nonEmptyStringArray"
+          }
+        },
+        "additionalProperties": true
+      }
+    }
+  },
+  "additionalProperties": true
+}

package/shells/canvas-overlay.json

@@ -0,0 +1,94 @@
+{
+  "$schema": "https://decantr.ai/schemas/shell.v1.json",
+  "id": "canvas-overlay",
+  "version": "1.0.0",
+  "decantr_compat": ">=2.0.0",
+  "name": "Canvas Overlay",
+  "description": "Full-bleed spatial shell with a primary canvas, floating toolbar overlays, and presence/status surfaces that sit above the canvas without consuming layout width.",
+  "layout": "stack",
+  "atoms": "_relative _h[100vh] _overflow-hidden",
+  "config": {
+    "regions": [
+      "header",
+      "body",
+      "overlay"
+    ],
+    "grid": {
+      "areas": [
+        [
+          "body"
+        ]
+      ]
+    },
+    "header": {
+      "height": "52px",
+      "sticky": false
+    },
+    "body": {
+      "scroll": false
+    }
+  },
+  "configurable": {
+    "header": {
+      "toggleable": true
+    },
+    "aside": {
+      "toggleable": true
+    },
+    "sizing": {
+      "headerHeight": {
+        "min": 44,
+        "max": 64,
+        "default": 52
+      }
+    }
+  },
+  "internal_layout": {
+    "root": {
+      "display": "grid",
+      "height": "100vh",
+      "atoms": "_relative _h[100vh] _overflow-hidden"
+    },
+    "header": {
+      "height": "52px",
+      "position": "absolute",
+      "top": "0",
+      "left": "0",
+      "right": "0",
+      "display": "flex",
+      "align": "center",
+      "justify": "space-between",
+      "padding": "0 clamp(1rem, 2vw, 1.5rem)",
+      "z_index": "40",
+      "background": "transparent",
+      "left_content": "Workspace title or breadcrumb anchor",
+      "right_content": "Secondary actions, view toggle, or collaborator summary. Keep controls compact so they do not dominate the canvas.",
+      "button_sizing": "Use compact controls in the overlay header: py-1.5 px-3 text-sm (~32px tall). Avoid oversized default button chrome."
+    },
+    "body": {
+      "position": "relative",
+      "height": "100vh",
+      "overflow": "hidden",
+      "atoms": "_relative _h[100vh] _overflow-hidden",
+      "note": "Primary full-bleed canvas lives here. This is not a card surface and should not inherit page-local shell padding."
+    },
+    "overlay": {
+      "position": "absolute",
+      "inset": "0",
+      "pointer_events": "none by default; interactive panels opt back in",
+      "z_index": "30",
+      "note": "Toolbar, presence indicators, and floating inspectors live above the canvas. These overlays must not consume permanent layout width."
+    }
+  },
+  "guidance": {
+    "shell_spacing": "Canvas-overlay owns the viewport edge insets for floating controls. Page components should place the canvas content and overlay surfaces only, not wrap them in extra shell-width containers or centered cards.",
+    "overlay_surfaces": "Floating inspectors and toolbars may use d-surface or theme decorators, but the base canvas should remain borderless and full-bleed.",
+    "mobile_behavior": "On narrow widths, collapse secondary overlay panels into bottom sheets or compact floating pills rather than shrinking the canvas itself.",
+    "section_label_treatment": "d-label[data-anchor]",
+    "section_density": "compact"
+  },
+  "code": {
+    "imports": "Target-specific imports vary. Translate the internal_layout contract into your framework's router outlet, canvas component, and overlay primitives.",
+    "example": "CanvasOverlayShell(root) -> Canvas(body as full-bleed viewport) + OverlayHeader(compact actions) + FloatingToolbar + PresenceIndicators + OptionalInspectorSheet"
+  }
+}