design.system

Čím návrh je: otisk, který nese každý stylopis, identita, sady písem, kontrakt motivu s prohlášením před vykreslením, které spouští každý povrch, šířky auditu, kolik tokenů každého druhu a každý vygenerovaný soubor, do něhož se deklarace promítá.

query
behaviorally_verified
module design
#design
#ui
#introspection

Zpřístupnění

Kde je tato jedna definice dosažitelná. Absence je explicitní: povrch, který není uveden, ji nenese.

povrch	jako
MCP	nástroj majordomus_design zdroj majordomus://design
HTTP	GET /api/v1/design operationId design.system
příkazová řádka	—

Schémata

Kanonický vstup a výstup z typů Rustu; schéma nástroje MCP a parametry a odpovědi OpenAPI se odvozují z nich.

vstup · Prázdné

Žádný vstup.

Žádné vlastnosti: schopnost nebere žádný vstup.

JSON Schema

{
  "additionalProperties": false,
  "description": "No input.",
  "title": "Empty",
  "type": "object"
}

výstup · DesignReport

Design systém: co to je a kam patří.

vlastnost	typ	povinné	popis
design	string	ano	Prvních dvanáct číslic, tak jak je nese každý stylesheet v `--mj-design`.
otisk	string	ano	SHA-256 kanonické podoby deklarace.
písmo	reference	ano	Dva typové stacky.
identity	reference	ano	Kdo to je.
projections	array	ano	Každý generovaný soubor, do kterého se deklarace promítá.
schema	integer	ano	Verze formátu deklarace.
zdroj	string	ano	Kde deklarace žije, relativně k repozitáři.
součty	reference	ano	Kolik tokenů každého druhu.
téma	reference	ano	Smlouva motivu.
viewporty	array	ano	Šířky, ve kterých audit v prohlížeči měří každou stránku.

JSON Schema

{
  "$defs": {
    "Fonts": {
      "additionalProperties": false,
      "description": "The two type stacks.",
      "properties": {
        "mono": {
          "description": "The monospace stack.",
          "type": "string"
        },
        "sans": {
          "description": "The system stack.",
          "type": "string"
        }
      },
      "required": [
        "sans",
        "mono"
      ],
      "type": "object"
    },
    "Identity": {
      "additionalProperties": false,
      "description": "Who this is.",
      "properties": {
        "logo": {
          "description": "The full logo, relative to the design directory.",
          "type": "string"
        },
        "mark": {
          "description": "The mark, relative to the design directory.",
          "type": "string"
        },
        "name": {
          "description": "The product name every surface shows.",
          "type": "string"
        },
        "social": {
          "description": "The social preview image, relative to the design directory.",
          "type": "string"
        }
      },
      "required": [
        "name",
        "mark",
        "logo",
        "social"
      ],
      "type": "object"
    },
    "ProjectionView": {
      "description": "One generated projection of the design and what it is for.",
      "properties": {
        "path": {
          "description": "Repository-relative path.",
          "type": "string"
        },
        "read_by": {
          "description": "What reads it.",
          "type": "string"
        }
      },
      "required": [
        "path",
        "read_by"
      ],
      "type": "object"
    },
    "ThemeView": {
      "description": "The theme contract as a client reads it.",
      "properties": {
        "bootstrap": {
          "description": "The one pre-paint statement every surface runs.",
          "type": "string"
        },
        "class": {
          "description": "The class on the root element that means dark.",
          "type": "string"
        },
        "storage_key": {
          "description": "The `localStorage` key the person's choice is kept under.",
          "type": "string"
        }
      },
      "required": [
        "class",
        "storage_key",
        "bootstrap"
      ],
      "type": "object"
    },
    "TokenTallies": {
      "description": "How many of each kind of token.",
      "properties": {
        "aliases": {
          "description": "Flowbite names declared as synonyms.",
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        },
        "palette": {
          "description": "Raw palette entries.",
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        },
        "roles": {
          "description": "Semantic roles.",
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        },
        "states": {
          "description": "State words filed under a status.",
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        },
        "statuses": {
          "description": "Status meanings.",
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        },
        "type_steps": {
          "description": "Steps of the type scale.",
          "format": "uint",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "palette",
        "roles",
        "statuses",
        "states",
        "type_steps",
        "aliases"
      ],
      "type": "object"
    }
  },
  "description": "The design system: what it is and where it goes.",
  "properties": {
    "design": {
      "description": "The first twelve digits, as every stylesheet carries them in `--mj-design`.",
      "type": "string"
    },
    "fingerprint": {
      "description": "SHA-256 of the declaration's canonical form.",
      "type": "string"
    },
    "font": {
      "$ref": "#/$defs/Fonts",
      "description": "The two type stacks."
    },
    "identity": {
      "$ref": "#/$defs/Identity",
      "description": "Who this is."
    },
    "projections": {
      "description": "Every generated file the declaration is projected into.",
      "items": {
        "$ref": "#/$defs/ProjectionView"
      },
      "type": "array"
    },
    "schema": {
      "description": "The format version of the declaration.",
      "format": "uint64",
      "minimum": 0,
      "type": "integer"
    },
    "source": {
      "description": "Where the declaration lives, repository-relative.",
      "type": "string"
    },
    "tallies": {
      "$ref": "#/$defs/TokenTallies",
      "description": "How many of each kind of token."
    },
    "theme": {
      "$ref": "#/$defs/ThemeView",
      "description": "The theme contract."
    },
    "viewports": {
      "description": "The widths a browser audit measures every page at.",
      "items": {
        "format": "uint32",
        "minimum": 0,
        "type": "integer"
      },
      "type": "array"
    }
  },
  "required": [
    "fingerprint",
    "design",
    "schema",
    "source",
    "identity",
    "font",
    "theme",
    "viewports",
    "tallies",
    "projections"
  ],
  "title": "DesignReport",
  "type": "object"
}

Politiky

benchmark: povinné — cíl na každém transportu, který expozice deklaruje; případy jsou ty ze vstupního typu
cache: vypnuto — každé volání spustí handler

Cíle benchmarku

Odvozeno z registru pro tento repozitář: jeden požadavek na transport a případy, které poskytuje typ vstupu. Celá matice je na stránce měření výkonu.

transport	state	případy	targets
direct	pokryto	1	výchozí
mcp	pokryto	1	výchozí
http	pokryto	1	výchozí