@ztothez/design-engineering 2.0.0

package/knowledge-base/design-intelligence/design-deliverable.schema.yaml

@@ -0,0 +1,1194 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+$id: https://local.ztothez-design-engineering/schemas/design-deliverable.schema.json
+title: ZtotheZ Design Engineering Design Deliverable
+description: >-
+  Versioned declaration for product tasks, linked trust and information contracts,
+  generation stages, design tokens, interface visual polish, brand systems, Figma
+  libraries, assets, iconography, presentations, rights evidence, rendered evidence,
+  human review status, and visual-accessibility checks.
+type: object
+additionalProperties: false
+required:
+  - version
+  - id
+  - product
+  - preparedAt
+  - preparedBy
+  - scope
+  - tokenSystem
+  - accessibility
+  - evidence
+properties:
+  version:
+    enum: ["1.0", "2.0", "2.1"]
+  id:
+    $ref: "#/$defs/id"
+  product:
+    $ref: "#/$defs/shortText"
+  preparedAt:
+    type: string
+    format: date-time
+  preparedBy:
+    type: object
+    additionalProperties: false
+    required: [type, name]
+    properties:
+      type:
+        enum: [agent, human, mixed]
+      name:
+        $ref: "#/$defs/shortText"
+  scope:
+    type: object
+    additionalProperties: false
+    required: [deliverables, audience, channels]
+    properties:
+      deliverables:
+        type: array
+        minItems: 1
+        maxItems: 6
+        uniqueItems: true
+        items:
+          enum: [interface-system, brand-system, figma-library, asset-set, icon-system, presentation]
+      audience:
+        $ref: "#/$defs/text"
+      channels:
+        type: array
+        minItems: 1
+        maxItems: 6
+        uniqueItems: true
+        items:
+          enum: [web, mobile, desktop, presentation, print, social]
+  tokenSystem:
+    type: object
+    additionalProperties: false
+    required: [tokens]
+    properties:
+      tokens:
+        type: array
+        minItems: 1
+        maxItems: 10000
+        items:
+          $ref: "#/$defs/token"
+      modes:
+        type: array
+        maxItems: 50
+        default: []
+        items:
+          $ref: "#/$defs/tokenMode"
+  productTask:
+    $ref: "#/$defs/productTask"
+  interfaceTrust:
+    $ref: "#/$defs/interfaceTrust"
+  informationHierarchy:
+    $ref: "#/$defs/informationHierarchy"
+  metricContracts:
+    $ref: "#/$defs/metricContracts"
+  generationWorkflow:
+    $ref: "#/$defs/generationWorkflow"
+  visualDirection:
+    $ref: "#/$defs/visualDirection"
+  typography:
+    $ref: "#/$defs/typography"
+  composition:
+    $ref: "#/$defs/composition"
+  densityProfile:
+    $ref: "#/$defs/densityProfile"
+  interactionStates:
+    $ref: "#/$defs/interactionStates"
+  motion:
+    $ref: "#/$defs/motion"
+  chartContracts:
+    type: array
+    maxItems: 500
+    items:
+      $ref: "#/$defs/chartContract"
+  renderedEvidence:
+    $ref: "#/$defs/renderedEvidence"
+  humanVisualReview:
+    $ref: "#/$defs/humanVisualReview"
+  brand:
+    $ref: "#/$defs/brand"
+  figma:
+    $ref: "#/$defs/figma"
+  assets:
+    type: array
+    default: []
+    items:
+      $ref: "#/$defs/asset"
+  iconSystem:
+    $ref: "#/$defs/iconSystem"
+  presentations:
+    type: array
+    default: []
+    items:
+      $ref: "#/$defs/presentation"
+  accessibility:
+    $ref: "#/$defs/accessibility"
+  evidence:
+    type: array
+    minItems: 1
+    maxItems: 1000
+    items:
+      $ref: "#/$defs/evidence"
+allOf:
+  - if:
+      properties:
+        scope:
+          properties:
+            deliverables:
+              contains:
+                const: interface-system
+    then:
+      properties:
+        version:
+          enum: ["2.0", "2.1"]
+      required: [productTask, interfaceTrust, informationHierarchy, metricContracts, generationWorkflow, visualDirection, typography, composition, densityProfile, interactionStates, motion, chartContracts, renderedEvidence, humanVisualReview]
+  - if:
+      properties:
+        version:
+          const: "2.1"
+    then:
+      properties:
+        assets:
+          items:
+            required: [purpose, failureBehavior]
+$defs:
+  id:
+    type: string
+    pattern: "^[a-z0-9][a-z0-9-]{0,63}$"
+  tokenName:
+    type: string
+    pattern: "^[a-z][a-z0-9-]*(?:[.][a-z0-9][a-z0-9-]*)+$"
+  shortText:
+    type: string
+    minLength: 1
+    maxLength: 256
+  text:
+    type: string
+    minLength: 1
+    maxLength: 1024
+  path:
+    type: string
+    minLength: 1
+    maxLength: 1024
+  token:
+    type: object
+    additionalProperties: false
+    required: [name, type, level, description]
+    properties:
+      name:
+        $ref: "#/$defs/tokenName"
+      type:
+        enum: [color, dimension, font-family, font-weight, duration, number, shadow]
+      level:
+        enum: [primitive, semantic, component]
+      value:
+        type: [string, number]
+      reference:
+        $ref: "#/$defs/tokenName"
+      description:
+        type: string
+        minLength: 1
+        maxLength: 512
+    allOf:
+      - if:
+          properties:
+            level:
+              const: primitive
+        then:
+          required: [value]
+          not:
+            required: [reference]
+        else:
+          required: [reference]
+          not:
+            required: [value]
+      - if:
+          properties:
+            type:
+              const: color
+          required: [value]
+        then:
+          properties:
+            value:
+              type: string
+              pattern: "^#[0-9a-fA-F]{6}$"
+  tokenMode:
+    type: object
+    additionalProperties: false
+    required: [name, overrides]
+    properties:
+      name:
+        $ref: "#/$defs/id"
+      overrides:
+        type: array
+        minItems: 1
+        maxItems: 2000
+        items:
+          type: object
+          additionalProperties: false
+          required: [token]
+          properties:
+            token:
+              $ref: "#/$defs/tokenName"
+            value:
+              type: [string, number]
+            reference:
+              $ref: "#/$defs/tokenName"
+          oneOf:
+            - required: [value]
+            - required: [reference]
+  productTask:
+    type: object
+    additionalProperties: false
+    required: [productContractId, contractPath, primaryUser, task, successCriteria, consequentialActions]
+    properties:
+      productContractId: { $ref: "#/$defs/id" }
+      contractPath: { $ref: "#/$defs/path" }
+      primaryUser: { $ref: "#/$defs/shortText" }
+      task: { $ref: "#/$defs/text" }
+      successCriteria:
+        type: array
+        minItems: 1
+        maxItems: 30
+        items: { type: string, minLength: 1, maxLength: 512 }
+      consequentialActions:
+        type: array
+        maxItems: 30
+        items: { type: string, minLength: 1, maxLength: 512 }
+  interfaceTrust:
+    type: object
+    additionalProperties: false
+    required: [contractId, contractPath, version, status, requiredScenarios]
+    properties:
+      contractId: { $ref: "#/$defs/id" }
+      contractPath: { $ref: "#/$defs/path" }
+      version: { const: "1.0" }
+      status: { enum: [declared, validated] }
+      requiredScenarios:
+        type: array
+        minItems: 5
+        maxItems: 5
+        uniqueItems: true
+        items: { enum: [demo, live, fallback, stale, disconnected] }
+      reportPath: { $ref: "#/$defs/path" }
+      evidenceRef: { $ref: "#/$defs/id" }
+  informationHierarchy:
+    type: object
+    additionalProperties: false
+    required: [contractId, contractPath, version, status, levels]
+    properties:
+      contractId: { $ref: "#/$defs/id" }
+      contractPath: { $ref: "#/$defs/path" }
+      version: { const: "1.0" }
+      status: { enum: [declared, validated] }
+      levels:
+        type: array
+        minItems: 8
+        maxItems: 8
+        uniqueItems: true
+        prefixItems:
+          - { const: context-provenance }
+          - { const: primary-outcome-action }
+          - { const: critical-exceptions }
+          - { const: health-impact-metrics }
+          - { const: prioritized-findings }
+          - { const: operational-telemetry }
+          - { const: evidence-audit-trail }
+          - { const: history-exports }
+        items: false
+      reportPath: { $ref: "#/$defs/path" }
+      evidenceRef: { $ref: "#/$defs/id" }
+  metricContracts:
+    type: object
+    additionalProperties: false
+    required: [informationContractId, metrics]
+    properties:
+      informationContractId: { $ref: "#/$defs/id" }
+      metrics:
+        type: array
+        minItems: 1
+        maxItems: 5000
+        items:
+          type: object
+          additionalProperties: false
+          required: [metricId, decision, hierarchyLevel, chartRefs]
+          properties:
+            metricId: { $ref: "#/$defs/id" }
+            decision: { type: string, minLength: 1, maxLength: 512 }
+            hierarchyLevel: { enum: [primary-outcome-action, health-impact-metrics, operational-telemetry] }
+            chartRefs:
+              type: array
+              maxItems: 50
+              items: { $ref: "#/$defs/id" }
+  generationWorkflow:
+    type: object
+    additionalProperties: false
+    required: [steps]
+    properties:
+      steps:
+        type: array
+        minItems: 9
+        maxItems: 9
+        items:
+          type: object
+          additionalProperties: false
+          required: [stage, status, artifactRefs]
+          properties:
+            stage: { enum: [product-task, truth-data-source-contract, information-architecture, interaction-state-model, visual-direction, token-architecture, implementation, automated-verification, human-visual-review] }
+            status: { enum: [required, declared, implemented, verified, review-required, review-completed] }
+            artifactRefs:
+              type: array
+              maxItems: 100
+              items: { $ref: "#/$defs/id" }
+  requiredViewport:
+    enum: [375, 768, 1024, 1440]
+  visualDirection:
+    type: object
+    additionalProperties: false
+    required: [domain, intent, principles, avoid, tokenRefs, ornamentPolicy, referenceEvidenceRefs]
+    properties:
+      domain: { $ref: "#/$defs/shortText" }
+      intent: { $ref: "#/$defs/text" }
+      principles:
+        type: array
+        minItems: 3
+        maxItems: 8
+        items: { $ref: "#/$defs/shortText" }
+      avoid:
+        type: array
+        minItems: 3
+        maxItems: 16
+        items: { $ref: "#/$defs/shortText" }
+      tokenRefs:
+        type: array
+        minItems: 4
+        maxItems: 100
+        items: { $ref: "#/$defs/tokenName" }
+      ornamentPolicy:
+        type: object
+        additionalProperties: false
+        required: [decorativeAgentDiagrams, excessiveGlow, meaninglessGradients, ornamentalStatusElements]
+        properties:
+          decorativeAgentDiagrams: { const: false }
+          excessiveGlow: { const: false }
+          meaninglessGradients: { const: false }
+          ornamentalStatusElements: { const: false }
+      referenceEvidenceRefs:
+        type: array
+        maxItems: 50
+        items: { $ref: "#/$defs/id" }
+  typography:
+    type: object
+    additionalProperties: false
+    required: [minimumBodySizePx, maximumLineLengthCharacters, numericAlignment, roles]
+    properties:
+      minimumBodySizePx: { type: number, minimum: 16, maximum: 32 }
+      maximumLineLengthCharacters: { type: integer, minimum: 45, maximum: 90 }
+      numericAlignment: { enum: [tabular, proportional] }
+      roles:
+        type: array
+        minItems: 8
+        maxItems: 8
+        items:
+          type: object
+          additionalProperties: false
+          required: [role, familyToken, sizeToken, weightToken, lineHeightToken, colorToken, usage]
+          properties:
+            role: { enum: [body, label, heading, metadata, metric, evidence, log, code] }
+            familyToken: { $ref: "#/$defs/tokenName" }
+            sizeToken: { $ref: "#/$defs/tokenName" }
+            weightToken: { $ref: "#/$defs/tokenName" }
+            lineHeightToken: { $ref: "#/$defs/tokenName" }
+            colorToken: { $ref: "#/$defs/tokenName" }
+            usage: { type: string, minLength: 1, maxLength: 512 }
+  composition:
+    type: object
+    additionalProperties: false
+    required: [contentWidth, grids, spacingRhythm, alignmentRules, stableDimensions, surfaces, borders, elevations, emphasis, selectedState]
+    properties:
+      contentWidth:
+        type: object
+        additionalProperties: false
+        required: [strategy, maximumPx]
+        properties:
+          strategy: { enum: [fluid, bounded, hybrid] }
+          maximumPx: { type: integer, minimum: 320, maximum: 2560 }
+      grids:
+        type: array
+        minItems: 4
+        maxItems: 4
+        items:
+          type: object
+          additionalProperties: false
+          required: [viewport, columns, gutterToken, marginToken, composition]
+          properties:
+            viewport: { $ref: "#/$defs/requiredViewport" }
+            columns: { type: integer, minimum: 1, maximum: 16 }
+            gutterToken: { $ref: "#/$defs/tokenName" }
+            marginToken: { $ref: "#/$defs/tokenName" }
+            composition: { type: string, minLength: 1, maxLength: 512 }
+      spacingRhythm:
+        type: object
+        additionalProperties: false
+        required: [baseToken, allowedStepTokens]
+        properties:
+          baseToken: { $ref: "#/$defs/tokenName" }
+          allowedStepTokens:
+            type: array
+            minItems: 4
+            maxItems: 16
+            items: { $ref: "#/$defs/tokenName" }
+      alignmentRules:
+        type: array
+        minItems: 2
+        maxItems: 12
+        items: { type: string, minLength: 1, maxLength: 512 }
+      stableDimensions:
+        type: array
+        minItems: 1
+        maxItems: 100
+        items:
+          type: object
+          additionalProperties: false
+          required: [component, behavior, tokenRefs, rationale]
+          properties:
+            component: { $ref: "#/$defs/id" }
+            behavior: { enum: [fixed, bounded, aspect-ratio] }
+            tokenRefs:
+              type: array
+              minItems: 1
+              maxItems: 10
+              items: { $ref: "#/$defs/tokenName" }
+            rationale: { type: string, minLength: 1, maxLength: 512 }
+      surfaces:
+        type: array
+        minItems: 3
+        maxItems: 5
+        items:
+          type: object
+          additionalProperties: false
+          required: [role, tokenRef]
+          properties:
+            role: { enum: [canvas, subtle, raised, overlay, inverse] }
+            tokenRef: { $ref: "#/$defs/tokenName" }
+      borders:
+        type: array
+        minItems: 4
+        maxItems: 4
+        items:
+          type: object
+          additionalProperties: false
+          required: [role, tokenRef]
+          properties:
+            role: { enum: [default, strong, focus, selected] }
+            tokenRef: { $ref: "#/$defs/tokenName" }
+      elevations:
+        type: array
+        minItems: 3
+        maxItems: 3
+        items:
+          type: object
+          additionalProperties: false
+          required: [role, tokenRef]
+          properties:
+            role: { enum: [base, raised, overlay] }
+            tokenRef: { $ref: "#/$defs/tokenName" }
+      emphasis:
+        type: array
+        minItems: 4
+        maxItems: 4
+        items:
+          type: object
+          additionalProperties: false
+          required: [level, textToken, surfaceToken]
+          properties:
+            level: { enum: [primary, secondary, tertiary, muted] }
+            textToken: { $ref: "#/$defs/tokenName" }
+            surfaceToken: { $ref: "#/$defs/tokenName" }
+      selectedState:
+        type: object
+        additionalProperties: false
+        required: [backgroundToken, borderToken, indicator, nonColorCue]
+        properties:
+          backgroundToken: { $ref: "#/$defs/tokenName" }
+          borderToken: { $ref: "#/$defs/tokenName" }
+          indicator: { $ref: "#/$defs/shortText" }
+          nonColorCue: { $ref: "#/$defs/shortText" }
+  densityProfile:
+    type: object
+    additionalProperties: false
+    required: [mode, rationale, controlHeightToken, rowHeightToken, compactRowHeightToken, spacingTokenRefs, maximumPrimaryActions, viewportBehavior]
+    properties:
+      mode: { enum: [comfortable, compact, dense, adaptive] }
+      rationale: { $ref: "#/$defs/text" }
+      controlHeightToken: { $ref: "#/$defs/tokenName" }
+      rowHeightToken: { $ref: "#/$defs/tokenName" }
+      compactRowHeightToken: { $ref: "#/$defs/tokenName" }
+      spacingTokenRefs:
+        type: array
+        minItems: 4
+        maxItems: 16
+        items: { $ref: "#/$defs/tokenName" }
+      maximumPrimaryActions: { type: integer, minimum: 1, maximum: 3 }
+      viewportBehavior:
+        type: array
+        minItems: 4
+        maxItems: 4
+        items:
+          type: object
+          additionalProperties: false
+          required: [viewport, mode, visiblePriorities]
+          properties:
+            viewport: { $ref: "#/$defs/requiredViewport" }
+            mode: { enum: [comfortable, compact, dense] }
+            visiblePriorities:
+              type: array
+              minItems: 1
+              maxItems: 8
+              items: { type: string, minLength: 1, maxLength: 160 }
+            priorityRoles:
+              type: array
+              minItems: 1
+              maxItems: 8
+              uniqueItems: true
+              items:
+                enum: [context, primary-outcome, critical-exceptions, impact, next-action, supporting-metrics, findings, telemetry, evidence, history]
+  interactionStates:
+    type: object
+    additionalProperties: false
+    required: [states]
+    properties:
+      states:
+        type: array
+        minItems: 9
+        maxItems: 9
+        items:
+          type: object
+          additionalProperties: false
+          required: [state, behavior, tokenRefs, textCue, iconCue]
+          properties:
+            state: { enum: [loading, empty, success, warning, error, partial, disabled, selected, focus] }
+            behavior: { type: string, minLength: 1, maxLength: 512 }
+            tokenRefs:
+              type: array
+              minItems: 1
+              maxItems: 20
+              items: { $ref: "#/$defs/tokenName" }
+            textCue: { type: boolean }
+            iconCue: { type: boolean }
+  motion:
+    type: object
+    additionalProperties: false
+    required: [durationTokens, motions, reducedMotion]
+    properties:
+      durationTokens:
+        type: object
+        additionalProperties: false
+        required: [instant, feedback, transition, emphasis]
+        properties:
+          instant: { $ref: "#/$defs/tokenName" }
+          feedback: { $ref: "#/$defs/tokenName" }
+          transition: { $ref: "#/$defs/tokenName" }
+          emphasis: { $ref: "#/$defs/tokenName" }
+      motions:
+        type: array
+        minItems: 1
+        maxItems: 100
+        items:
+          type: object
+          additionalProperties: false
+          required: [id, purpose, trigger, property, durationCategory, interruptible]
+          properties:
+            id: { $ref: "#/$defs/id" }
+            purpose: { type: string, minLength: 1, maxLength: 512 }
+            trigger: { $ref: "#/$defs/shortText" }
+            property: { enum: [opacity, transform, color, size, position, progress] }
+            durationCategory: { enum: [instant, feedback, transition, emphasis] }
+            interruptible: { type: boolean }
+      reducedMotion:
+        type: object
+        additionalProperties: false
+        required: [strategy, equivalents]
+        properties:
+          strategy: { enum: [remove, replace, shorten] }
+          equivalents:
+            type: array
+            minItems: 1
+            maxItems: 100
+            items:
+              type: object
+              additionalProperties: false
+              required: [motionRef, behavior]
+              properties:
+                motionRef: { $ref: "#/$defs/id" }
+                behavior: { type: string, minLength: 1, maxLength: 512 }
+  chartContract:
+    type: object
+    additionalProperties: false
+    required: [id, purpose, type, metricRefs, labelStrategy, titleVisible, valuesVisible, legend, comparison, alternative, states, tokenRefs, nonColorCues, decorative]
+    properties:
+      id: { $ref: "#/$defs/id" }
+      purpose: { $ref: "#/$defs/text" }
+      type: { enum: [bar, line, area, scatter, distribution, timeline, table-first] }
+      metricRefs:
+        type: array
+        minItems: 1
+        maxItems: 50
+        items: { $ref: "#/$defs/id" }
+      labelStrategy: { enum: [direct, axis-and-legend, table-first] }
+      titleVisible: { type: boolean }
+      valuesVisible: { type: boolean }
+      legend:
+        type: object
+        additionalProperties: false
+        required: [visible]
+        properties:
+          visible: { type: boolean }
+          reason: { type: string, minLength: 1, maxLength: 512 }
+      comparison:
+        oneOf:
+          - type: object
+            additionalProperties: false
+            required: [status, context]
+            properties:
+              status: { const: available }
+              context: { type: string, minLength: 1, maxLength: 512 }
+          - type: object
+            additionalProperties: false
+            required: [status, reason]
+            properties:
+              status: { const: not-applicable }
+              reason: { type: string, minLength: 1, maxLength: 512 }
+      alternative:
+        type: object
+        additionalProperties: false
+        required: [kind, path]
+        properties:
+          kind: { enum: [table, text] }
+          path: { $ref: "#/$defs/path" }
+      states:
+        type: object
+        additionalProperties: false
+        required: [loading, empty, partial, error]
+        properties:
+          loading: { type: string, minLength: 1, maxLength: 512 }
+          empty: { type: string, minLength: 1, maxLength: 512 }
+          partial: { type: string, minLength: 1, maxLength: 512 }
+          error: { type: string, minLength: 1, maxLength: 512 }
+      tokenRefs:
+        type: array
+        minItems: 2
+        maxItems: 30
+        items: { $ref: "#/$defs/tokenName" }
+      backgroundToken:
+        $ref: "#/$defs/tokenName"
+      nonColorCues:
+        type: array
+        minItems: 2
+        maxItems: 8
+        uniqueItems: true
+        contains: { enum: [text, icon, shape, pattern, position, value, line-style] }
+        items: { enum: [color, text, icon, shape, pattern, position, value, line-style] }
+      decorative: { const: false }
+  renderedEvidence:
+    type: object
+    additionalProperties: false
+    required: [fixture, captures]
+    properties:
+      fixture:
+        type: object
+        additionalProperties: false
+        required: [id, sourcePath, route]
+        properties:
+          id: { $ref: "#/$defs/id" }
+          sourcePath: { $ref: "#/$defs/path" }
+          route: { $ref: "#/$defs/text" }
+      captures:
+        type: array
+        minItems: 4
+        maxItems: 4
+        items:
+          oneOf:
+            - type: object
+              additionalProperties: false
+              required: [viewport, status]
+              properties:
+                viewport: { $ref: "#/$defs/requiredViewport" }
+                status: { const: planned }
+            - type: object
+              additionalProperties: false
+              required: [viewport, status, screenshotPath, runtimeReportPath, sha256]
+              properties:
+                viewport: { $ref: "#/$defs/requiredViewport" }
+                status: { enum: [captured, verified] }
+                screenshotPath: { $ref: "#/$defs/path" }
+                runtimeReportPath: { $ref: "#/$defs/path" }
+                sha256: { type: string, pattern: "^[a-f0-9]{64}$" }
+  humanVisualReview:
+    type: object
+    additionalProperties: false
+    required: [status, dimensions, reviewers]
+    properties:
+      status: { enum: [required, completed] }
+      dimensions:
+        type: array
+        minItems: 5
+        maxItems: 5
+        uniqueItems: true
+        items: { enum: [hierarchy, balance, scanability, density, domain-fit] }
+      reviewers:
+        type: array
+        maxItems: 50
+        items:
+          type: object
+          additionalProperties: false
+          required: [name, role, reviewedAt, evidenceRef]
+          properties:
+            name: { $ref: "#/$defs/shortText" }
+            role: { $ref: "#/$defs/shortText" }
+            reviewedAt: { type: string, format: date-time }
+            evidenceRef: { $ref: "#/$defs/id" }
+  brand:
+    type: object
+    additionalProperties: false
+    required: [promise, audiences, attributes, avoid, voicePrinciples, marks]
+    properties:
+      promise:
+        $ref: "#/$defs/text"
+      audiences:
+        type: array
+        minItems: 1
+        maxItems: 20
+        items:
+          $ref: "#/$defs/shortText"
+      attributes:
+        type: array
+        minItems: 2
+        maxItems: 8
+        items:
+          type: string
+          minLength: 1
+          maxLength: 80
+      avoid:
+        type: array
+        minItems: 1
+        maxItems: 12
+        items:
+          type: string
+          minLength: 1
+          maxLength: 160
+      voicePrinciples:
+        type: array
+        minItems: 2
+        maxItems: 12
+        items:
+          $ref: "#/$defs/shortText"
+      marks:
+        type: array
+        minItems: 1
+        maxItems: 30
+        items:
+          type: object
+          additionalProperties: false
+          required: [id, role, asset, clearSpace, minimumSize, allowedBackgrounds]
+          properties:
+            id:
+              $ref: "#/$defs/id"
+            role:
+              enum: [primary, compact, monochrome, symbol, wordmark]
+            asset:
+              $ref: "#/$defs/id"
+            clearSpace:
+              $ref: "#/$defs/shortText"
+            minimumSize:
+              $ref: "#/$defs/shortText"
+            allowedBackgrounds:
+              type: array
+              minItems: 1
+              maxItems: 12
+              items:
+                type: string
+                minLength: 1
+                maxLength: 128
+  figma:
+    type: object
+    additionalProperties: false
+    required: [pages, collections, components]
+    properties:
+      pages:
+        type: array
+        minItems: 2
+        maxItems: 50
+        items:
+          type: object
+          additionalProperties: false
+          required: [name, role, purpose]
+          properties:
+            name:
+              type: string
+              minLength: 1
+              maxLength: 128
+            role:
+              enum: [cover, foundations, components, patterns, templates, sandbox, archive]
+            purpose:
+              type: string
+              minLength: 1
+              maxLength: 512
+      collections:
+        type: array
+        minItems: 1
+        maxItems: 100
+        items:
+          type: object
+          additionalProperties: false
+          required: [name, modes, tokens]
+          properties:
+            name:
+              type: string
+              minLength: 1
+              maxLength: 128
+            modes:
+              type: array
+              minItems: 1
+              maxItems: 20
+              items:
+                $ref: "#/$defs/id"
+            tokens:
+              type: array
+              minItems: 1
+              maxItems: 5000
+              items:
+                $ref: "#/$defs/tokenName"
+      components:
+        type: array
+        minItems: 1
+        maxItems: 1000
+        items:
+          type: object
+          additionalProperties: false
+          required: [name, purpose, interactive, properties, states, documented]
+          properties:
+            name:
+              type: string
+              minLength: 1
+              maxLength: 160
+            purpose:
+              type: string
+              minLength: 1
+              maxLength: 512
+            interactive:
+              type: boolean
+            properties:
+              type: array
+              maxItems: 40
+              items:
+                type: object
+                additionalProperties: false
+                required: [name, type]
+                properties:
+                  name:
+                    type: string
+                    minLength: 1
+                    maxLength: 128
+                  type:
+                    enum: [boolean, instance-swap, text, variant, slot]
+            states:
+              type: array
+              minItems: 1
+              maxItems: 30
+              items:
+                $ref: "#/$defs/id"
+            documented:
+              type: boolean
+  asset:
+    type: object
+    additionalProperties: false
+    required: [id, kind, path, source, rights, alternative]
+    properties:
+      id:
+        $ref: "#/$defs/id"
+      purpose:
+        $ref: "#/$defs/text"
+      kind:
+        enum: [logo, icon, illustration, photo, texture, chart, screenshot, video, audio, font]
+      path:
+        $ref: "#/$defs/path"
+      source:
+        type: object
+        additionalProperties: false
+        required: [origin, creator]
+        properties:
+          origin:
+            enum: [original, user-provided, generated, commissioned, licensed, open-source, public-domain]
+          creator:
+            $ref: "#/$defs/shortText"
+          sourceUrl:
+            type: string
+            format: uri
+      rights:
+        $ref: "#/$defs/rights"
+      generation:
+        $ref: "#/$defs/generation"
+      alternative:
+        type: object
+        additionalProperties: false
+        required: [kind]
+        properties:
+          kind:
+            enum: [decorative, short-text, long-description, data-table, caption, transcript]
+          content:
+            type: string
+            minLength: 1
+            maxLength: 4096
+      failureBehavior:
+        type: object
+        additionalProperties: false
+        required: [strategy, behavior]
+        properties:
+          strategy:
+            enum: [hide-decorative, text-alternative, placeholder, retry, block]
+          behavior:
+            $ref: "#/$defs/text"
+  rights:
+    type: object
+    additionalProperties: false
+    required: [status, basis]
+    properties:
+      status:
+        enum: [approved, pending, rejected, unknown]
+      basis:
+        enum: [owned, contract, terms-of-service, spdx-license, public-domain, permission]
+      spdxExpression:
+        $ref: "#/$defs/shortText"
+      evidence:
+        $ref: "#/$defs/path"
+      attribution:
+        $ref: "#/$defs/text"
+      restrictions:
+        type: array
+        default: []
+        maxItems: 30
+        items:
+          type: string
+          minLength: 1
+          maxLength: 512
+      reviewedBy:
+        $ref: "#/$defs/shortText"
+      reviewedAt:
+        type: string
+        format: date-time
+  generation:
+    type: object
+    additionalProperties: false
+    required: [provider, model, promptRecord, humanContributions, references]
+    properties:
+      provider:
+        $ref: "#/$defs/shortText"
+      model:
+        $ref: "#/$defs/shortText"
+      promptRecord:
+        $ref: "#/$defs/path"
+      humanContributions:
+        type: array
+        minItems: 1
+        maxItems: 30
+        items:
+          type: string
+          minLength: 1
+          maxLength: 512
+      references:
+        type: array
+        maxItems: 50
+        items:
+          type: object
+          additionalProperties: false
+          required: [source, rightsStatus]
+          properties:
+            source:
+              $ref: "#/$defs/text"
+            rightsStatus:
+              enum: [approved, pending, rejected, unknown]
+            evidence:
+              $ref: "#/$defs/path"
+  iconSystem:
+    type: object
+    additionalProperties: false
+    required: [name, grid, sizes, stroke, icons]
+    properties:
+      name:
+        type: string
+        minLength: 1
+        maxLength: 160
+      grid:
+        type: integer
+        minimum: 8
+        maximum: 128
+      sizes:
+        type: array
+        minItems: 1
+        maxItems: 20
+        items:
+          type: integer
+          minimum: 8
+          maximum: 512
+      stroke:
+        type: object
+        additionalProperties: false
+        required: [style, weight, linecap, linejoin]
+        properties:
+          style:
+            enum: [outline, filled, duotone, mixed]
+          weight:
+            type: number
+            exclusiveMinimum: 0
+            maximum: 16
+          linecap:
+            enum: [round, square, butt]
+          linejoin:
+            enum: [round, bevel, miter]
+      icons:
+        type: array
+        minItems: 1
+        maxItems: 2000
+        items:
+          type: object
+          additionalProperties: false
+          required: [id, name, meaning, asset, decorative]
+          properties:
+            id:
+              $ref: "#/$defs/id"
+            name:
+              type: string
+              minLength: 1
+              maxLength: 128
+            meaning:
+              type: string
+              minLength: 1
+              maxLength: 512
+            asset:
+              $ref: "#/$defs/id"
+            decorative:
+              type: boolean
+            accessibleName:
+              $ref: "#/$defs/shortText"
+  presentation:
+    type: object
+    additionalProperties: false
+    required: [id, purpose, audience, aspectRatio, masterLayouts, slides]
+    properties:
+      id:
+        $ref: "#/$defs/id"
+      purpose:
+        type: string
+        minLength: 1
+        maxLength: 512
+      audience:
+        $ref: "#/$defs/shortText"
+      aspectRatio:
+        enum: ["16:9", "4:3", "1:1", a4-landscape, a4-portrait]
+      masterLayouts:
+        type: array
+        minItems: 2
+        maxItems: 40
+        items:
+          $ref: "#/$defs/id"
+      slides:
+        type: array
+        minItems: 1
+        maxItems: 500
+        items:
+          type: object
+          additionalProperties: false
+          required: [id, title, purpose, layout, readingOrder, assets]
+          properties:
+            id:
+              $ref: "#/$defs/id"
+            title:
+              $ref: "#/$defs/shortText"
+            purpose:
+              type: string
+              minLength: 1
+              maxLength: 512
+            layout:
+              $ref: "#/$defs/id"
+            readingOrder:
+              type: array
+              minItems: 1
+              maxItems: 50
+              items:
+                type: string
+                minLength: 1
+                maxLength: 128
+            assets:
+              type: array
+              maxItems: 50
+              items:
+                $ref: "#/$defs/id"
+            speakerNotes:
+              type: string
+              minLength: 1
+              maxLength: 4096
+  accessibility:
+    type: object
+    additionalProperties: false
+    required: [contrastPairs, nonColorCues]
+    properties:
+      contrastPairs:
+        type: array
+        minItems: 1
+        maxItems: 2000
+        items:
+          type: object
+          additionalProperties: false
+          required: [id, foreground, background, usage]
+          properties:
+            id:
+              $ref: "#/$defs/id"
+            foreground:
+              $ref: "#/$defs/tokenName"
+            background:
+              $ref: "#/$defs/tokenName"
+            usage:
+              enum: [normal-text, large-text, non-text]
+            mode:
+              $ref: "#/$defs/id"
+            fontSizePx:
+              type: number
+              exclusiveMinimum: 0
+              maximum: 1000
+            fontWeight:
+              type: integer
+              minimum: 100
+              maximum: 1000
+      nonColorCues:
+        type: array
+        minItems: 1
+        maxItems: 100
+        items:
+          type: object
+          additionalProperties: false
+          required: [meaning, cues]
+          properties:
+            meaning:
+              $ref: "#/$defs/shortText"
+            cues:
+              type: array
+              minItems: 2
+              maxItems: 8
+              uniqueItems: true
+              items:
+                enum: [color, text, icon, shape, pattern, position, value, underline]
+  evidence:
+    type: object
+    additionalProperties: false
+    required: [id, kind, path, detail]
+    properties:
+      id:
+        $ref: "#/$defs/id"
+      kind:
+        enum: [source, review, contrast, export, license, runtime]
+      path:
+        $ref: "#/$defs/path"
+      detail:
+        $ref: "#/$defs/text"